Send Candidates API integration guide
Integrate the API to sync candidate applications with 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 Send Candidates API to submit and track candidate applications. Submitting an application takes three steps: initialize, upload attachments, and submit.
Initialization stages an application version with Indeed and returns URLs for uploading attachments. Each initialization creates a version with a unique applicationVersionId. After initialization, you have five minutes to upload attachments and submit.
Integration steps
1. Sign a Developer Agreement with Indeed
Sign a Developer Agreement between your company and Indeed, then submit a formal integration request through Become an Indeed partner.
After Indeed approves your account, it enables access and sends a questionnaire about your integration.
2. Authenticate
When you become an Indeed partner, Indeed creates an app for your integration. Sign in to Partner Console to view the app and your OAuth credentials: client ID, secret, and a 3-legged OAuth authorization code. Exchange those credentials for an access token to authenticate API calls.
Authenticate with a 2-legged OAuth token. Your app authenticates with Indeed's authorization server with no user interaction.
3. Develop and test your integration
-
Develop your integration.
-
Confirm that:
- You do not get common GraphQL errors when sending candidates.
- You can delete candidates.
4. Get approval for your integration
Indeed emails you after it approves your integration.
See also
- Partner Console > Credentials
- Client credentials grant type (2-legged OAuth)
- Integrate with Indeed and call APIs
- Common GraphQL error codes