Candidate Ingestion API

REST discovered

Details

URL: https://api.greenhouse.io/v1/partners
Docs: https://developers.greenhouse.io/candidate-ingestion.html

Authentication

Candidate Ingestion OAuth app oauth2 discovered Set up OAuth ↗

Authorization: Bearer <credential>

For Candidate Ingestion OAuth, provide Greenhouse with your application name, application URL, callback URL, and logo as described in Candidate Ingestion authentication. Greenhouse then supplies a consumer key, consumer secret, token URL, and authorize URL for the OAuth 2.0 flow. Use the resulting bearer access token in API requests.

Partner API key Authorization: Basic <credential> + Service user email for On-Behalf-Of On-Behalf-Of: <credential> discovered

Partner API key basic Get credentials ↗

For Candidate Ingestion basic auth, the customer supplies the partner with a Partner API Key and a service user, per Candidate Ingestion authentication. Use the Partner API key as the HTTP Basic username with an empty password (api_key:), and send the service user's email in the On-Behalf-Of header on every request.

Service user email for On-Behalf-Of compound

For Candidate Ingestion basic authentication, use the active Greenhouse service user's email address in the On-Behalf-Of header on every request, as required by Candidate Ingestion authentication. This user is typically created specifically for the integration and must be recognized by Greenhouse.