Post

This webhook feeds data whenever a Post is created or updated, including when the posting gets queued and also leaves the posting queue. You can use this webhook to track when a posting process is started and completed for a given Vacancy, and confirm if Posts to specific destinations were successful.

Data

Every webhook payload contains the following data:

• id - post's unique identifier inside the idibu system
• job_title - title of the job
• location - location of the job
  • country - 2-letter ISO country code
  • place - detailed location, such as city, region, etc.
• salary - remuneration info
  • currency - 3-letter ISO currency code
  • salary_min - minimum salary
  • salary_max - maximum salary
  • salary_per - salary period - can be either annum, month, week, day, or hour
• benefits - extra benefits aside from the salary
• job_reference - reference of the job
• job_sector - category of the job (label)
• job_type - job type's short code - a combination of two letters: (C - Contract; P - Permanent; T - Temporary) + (F - Full-time; P - Part-time) - e.g., PF for "Permanent Full-time"
• duration - contract duration, only available for Contract and Temporary
• description - full description of the job
• application_url - external URL to which the applicants will be redirected, if supported by the posting destinations
• start_date - timestamp of when the job starts
• creation_date - timestamp of when the post was created in the system
• created_by - identifies the original owner of the post
  • id - unique identifier of the company account inside the idibu system
  • profile_id - unique identifier of the user profile inside the idibu system
  • email - consultant's email address
  • firstname - consultant's first name
  • lastname - consultant's last name
  • group - identifies the group to which the user is assigned
    • id - unique identifier of the group
    • label - name of the group
  • subgroup - identifies the subgroup to which the user is assigned
    • id - unique identifier of the subgroup
    • parent_id - unique identifier of the group to which the subgroup is assigned
    • label - name of the subgroup
• vacancy - information about the related vacancy
  • id - vacancy's unique identifier inside the idibu system
  • reference - vacancy reference
  • title - vacancy title
• destinations - list of destinations (Portals) the job was posted to - can contain multiple items
  • id - unique identifier of the Portal
  • name - Portal name
  • status - pending will indicate a new post that is still queued; once the posting process is completed, a post.update event will be sent and the status will either be success, deleted, or failed; expired indicates old posts that already expired on their destinations
• post_account - identifies the user profile that posted the job
  • firstname - consultant's first name
  • lastname - consultant's last name
• payload-information
  • timestamp - the exact timestamp of when the webhook was sent
  • webhook_event - either post.create or post.update

Example webhook request

Headers

Request URL: https://webhook.site/abcdef12-3456-7890-abcd-ef1234567890
Request method: POST
User-Agent: Idibu-Hookshot
X-IdibuV3-Delivery: 123e4567-e89b-12d3-a456-426614174000
X-IdibuV3-Event: update.post
Content-Type: application/json

Payload

{
	"payload": {
		"id": "12345",
		"job_title": "Job Title",
		"location": {
			"country": "GB",
			"place": "London"
		},
		"salary": {
			"currency": "USD",
			"salary_min": "12.34",
			"salary_max": "56.78",
			"salary_per": "hour"
		},
		"benefits": "Job benefits",
		"job_reference": "WH6-QRD",
		"job_sector": "IT",
		"job_type": "PF",
		"duration": "1 month",
		"description": "Job<br/>Description",
		"application_url": "https://example.com/apply/abc123",
		"start_date": "2025-05-01T00:00:00+01:00",
		"creation_date": "2025-04-02T21:37:00+02:00",
		"created_by": {
			"id": "123",
			"profile_id": "456",
			"email": "test@example.com",
			"firstname": "Test",
			"lastname": "User",
			"group": {
				"id": "789",
				"label": "Test Group"
			},
			"subgroup": {
				"id": "790",
				"parent_id": "789",
				"label": "Test Subgroup"
			}
		},
		"vacancy": {
			"id": "54321",
			"reference": "WH6-QRD",
			"title": "Job Title"
		},
		"destinations": [
			{
				"id": "1234",
				"name": "idibu Test Portal",
				"status": "success"
			}
		],
		"post_account": {
			"firstname": "Test",
			"lastname": "User"
		}
	},
	"payload-information": {
		"timestamp": "2025-04-02T22:00:00+02:00",
		"webhook_event": "post.create"
	}
}