Bulk create candidates

Asynchronously create many candidate profiles in a single call, typically for HRIS sync workflows that create a batch of candidates at once. Each item follows the same shape as POST /v3/candidates, with first_name and last_name required; all other profile fields are optional. Pass a nested application object to create the candidate's first application — supply a job_id to create an applicant, or a prospect_pool_id (and omit job_id) to create a prospect. A bulk_action_uuid is returned immediately. Per-item success or failure is reported through GET /v3/bulk_requests/{bulk_action_uuid}.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
length ≤ 255

Optional HTTPS URL Greenhouse will POST to when every row in data has finished. Omit to poll GET /v3/bulk_requests/{bulk_action_uuid} instead.

data
array of objects
required

Array of single-resource create payloads to process. Each item must match the schema of the matching non-bulk POST endpoint; rows are validated and executed independently in their own Sidekiq jobs.

data*
Responses

401

Unauthorized

413

Payload is larger than 10MB

422

Validation Error

429

Client has more than 5 active jobs

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json