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

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.

Data schema

Property	Type	Required	Description	Constraints
employerJobId	string	✓	Base64-encoded IRI of the employer job.
lifecycleEvent	enum	✓	The job's lifecycle event.	Values: "UPDATED" "EXPIRED"

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.

1. Create an HTTPS endpoint on your server to receive POST requests.

2. In Partner Console, go to Apps > Your App > Webhooks > Create a Webhook and provide your endpoint URL and shared secret.

3. 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.

 

Was this page helpful?