Jobs lifecycle events webhooks guide
Information about the jobs lifecycle status event schema and data schema.
Webhooks workflow
See Webhooks guide to learn how webhooks work and complete the partner integration checklist.
Jobs lifecycle status event schema
| Event type | com.indeed.partner.jobs.lifecycle_event.v1 |
|---|---|
| Description | Job lifecycle event notification. In V1, status "UPDATED" includes job creation and update events. |
Data schema
Data content type: application/json. JSON Schema:
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
employerJobId | string | ✓ | Base64-encoded EJID IRI. | |
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. Supports TLS v1.2 and 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.