Jobs lifecycle events webhooks guide
Jobs lifecycle status event schema and data schema.
Webhooks workflow
#See Webhooks guide to learn how webhooks work and complete the partner integration checklist.
With Publish on job update selected, each UPDATED event is for a held job that stays hidden until you publish it. See Delayed publishing guide.
Jobs lifecycle status event schema
#| Event type | com.indeed.partner.jobs.lifecycle_event.v1 |
|---|---|
| Description | Notifies you of a job lifecycle event. In v1, the "UPDATED" status covers both job creation and job updates. |
Data schema
#The data content type is application/json.
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
employerJobId | string | ✓ | Base64-encoded IRI of the employer job. | |
lifecycleEvent | enum | ✓ | The job's lifecycle event. | Values:
|
Example webhook payload
#{ "specversion": "1.0", "id": "evt_12345678-1234-1234-1234-123456789abc", "source": "api.indeed.com", "type": "com.indeed.partner.jobs.lifecycle_event.v1", "time": "2023-11-20T10:30:00.456Z", "datacontenttype": "application/json", "idempotencykey": "1000070919164-1769477612123", "data": { "employerJobId": "ejid_active_job_123", "lifecycleEvent": "UPDATED" }}Configure HTTPS endpoint with SSL certificate
#Production webhook endpoints must use HTTPS with TLS v1.2 or v1.3.
-
Create an HTTPS endpoint on your server to receive
POSTrequests. -
In Partner Console, go to Apps > Your App > Webhooks > Create a Webhook and provide your endpoint URL and shared secret.
-
Select a job from your client's feed (organic or Indeed-crawled).
Indeed uses this job to determine which updates to send based on the job source.