Disposition Sync API integration guide
Integrate the API to send job application disposition data to Indeed.
By using this API and its documentation and building an integration, you agree to the Additional API Terms and Guidelines.
Integration overview
Integrate the Disposition Sync API to send disposition data for Indeed Apply and non-Indeed Apply jobs to Indeed.
To submit disposition data to Indeed, you must integrate the Disposition Sync API.
Integration steps
1. Sign a Developer Agreement with Indeed
Sign a Developer Agreement with Indeed, then submit an integration request through Become an Indeed partner.
After Indeed approves your account, it enables access and sends a questionnaire about your integration.
2. Authenticate
After you become a partner, Indeed creates an app that integrates Indeed APIs and services into your product. Use Partner Console to get the app’s OAuth client ID and secret.
Exchange the client ID and secret for an access token to authenticate Disposition Sync API calls. The token expires after one hour.
3. Send ATS disposition data to Indeed
Send ATS disposition data to Indeed for every Indeed-sourced job application.
Follow these guidelines:
- When the ATS receives the application, send at least one disposition with
dispositionStatusset toNEW. - Map each disposition to the closest Indeed standard disposition status.
- Send updates when applications change, either immediately or at least once a day.
- In each request, sort dispositions by status-change timestamp, oldest first.
- Avoid duplicate disposition statuses when you can, though duplicates are allowed.
- Send multiple unique statuses for an application in one request or across requests.
- Send at most 25 dispositions per request. Split larger batches.
- Use real identifiers:
indeedApplyID,ittk,universalApplyId, andalternateIdentifier.
Integration phases
Phase 1: Review
Indeed stores the disposition data you send in the sandbox database and reviews it to confirm the integration works and the disposition status mapping is accurate.
Phase 2: Production
Indeed stores the disposition data you send in the production database.
See also
- Credentials
- Get an access token
- Indeed standard disposition statuses
- Send disposition data for Indeed Apply jobs