Skip to main content
POST
Invite multiple candidates at once
Use this API to invite multiple candidates to a specific Interviewer at once.
Rate limit: 100 requests per minute per API key. Requests over the limit return 429 Too Many Requests.

Payload structure

string
required
The unique ID of the Interviewer to ingest Candidates into.
string
shortlisted or draft. Controls the onboarding experience.
string[]
Skills used to generate custom questions, such as nodejs, aws, and mongodb.
object[]
required
Candidates to invite.
string
required
Candidate’s full name.
string
required
Candidate’s email address.
object
Custom key-value fields to tag against the Candidate, such as scores or flags.
object
External reference data, such as an ATS ID or phone number. This data is not used in scoring.
number
Hours to delay the invitation email. Minimum 1 and maximum 96.

Status routing

Default behavior (when status is omitted)

Example request

Best Practice: Trigger this API call automatically when a candidate reaches a specific stage in your ATS (e.g. “Phone Screen” or “AI Interview”).