Delayed publishing guide
Review a client's job before job seekers see it.
By using this API and its documentation and building an integration, you agree to the Additional API Terms and Guidelines.
Overview
#This feature is in beta. To join, contact your Indeed representative. Indeed will tell you when it's fully available.
As an ad agency, use delayed publishing to review a client's job before job seekers see it. Indeed holds each new or updated job from your client's ATS until you publish it with the Job Update API. A held job never publishes on its own.
Delayed publishing isn't available in Japan.
1. Authenticate
#See Authenticate.
2. Enable delayed publishing
#- In Partner Console, open your app and create or edit a webhook subscription for
com.indeed.partner.jobs.lifecycle_event.v1. - Select Publish on job update.
- Save the subscription.
Indeed now holds new and updated jobs from the client feeds that the subscription covers until you publish them. If you clear Publish on job update, Indeed publishes each job shortly after it notifies you.
If more than one subscription covers a client feed, Indeed holds the job if any of them has Publish on job update selected.
3. Receive a webhook
#When a client's job is created or updated, Indeed sends a jobs lifecycle event with status UPDATED and holds the job. See the Jobs lifecycle events webhooks guide.
4. Review the job posting
#To get the job, call the node query with the job IRI from the webhook payload. See Get job posting status by ID.
5. Publish job posting
#| Operation | Publishes a held job? |
|---|---|
updateSourcedJobPostings | Yes, if the update succeeds. If it fails, the job stays held. |
publishSourcedJobPostings | Yes. Use it when the job needs no changes. |
clearSourcedJobPostingUpdates | No. |
Either update and publish the job, or publish it without changes:
-
Update and publish: Call
updateSourcedJobPostingsas Update job posting describes. No extra fields are needed. Indeed applies your update before it publishes the job, so job seekers see only the updated version.If the update succeeds but the publish fails, the response includes a publish error. Indeed saves your update, but the job stays held. To publish it, call
publishSourcedJobPostings. -
Publish without changes: Call
publishSourcedJobPostings. If the job isn't held, the call succeeds but publishes nothing.
Request – Publish job posting
#Call the publishSourcedJobPostings mutation with an access token that represents the advertiser and has the employer_access and employer.hosted_job scopes. See Get access token that represents employer.
input.publishes accepts one job per call. In employerJob, identify the job with exactly one of sourcedPostingId or employerJobId. The employerJobId is the EmployerJob.id from findEmployerJobsPartner or the webhook payload.
mutation PublishSourcedJobPostings { jobsIngest { publishSourcedJobPostings(input: { publishes: [{ employerJob: { employerJobId: "<EMPLOYER JOB ID>" } }] }) { results { sourcedPostingId employerJobId seatsPublished } } }}Response – Publish job posting
#results has one entry per publish, with sourcedPostingId, employerJobId, and seatsPublished. The seatsPublished value shows the result:
- Greater than
0— Indeed published the job. 0— The job wasn't held.null— The publish failed. The response includes an error.
{ "data": { "jobsIngest": { "publishSourcedJobPostings": { "results": [{ "sourcedPostingId": "opaqueId", "employerJobId": "opaqueId", "seatsPublished": 1 }] } } }}6. Find held jobs
#The Job Update API doesn't show which jobs are held yet. Keep track of the jobs that you receive in webhooks, and publish each one after you review it.
7. Repeat for each update
#Indeed holds the job again each time the client's ATS updates it, even if you published an earlier version. Repeat Receive a webhook, Review the job posting, and Publish job posting.
For example, if you publish a job on Monday and the client changes its description on Tuesday, Indeed holds the job until you publish it again.
GraphQL API reference
#clearSourcedJobPostingUpdates— Clears job updates.findEmployerJobsPartner— Lists jobs for an employer.node— Gets one job by ID.nodes— Gets multiple jobs by IDs.publishSourcedJobPostings— Publishes a held job so job seekers can see it.updateSourcedJobPostings— Updates supported job fields.