Create an application
Create a job application. Phone must be E.164. The interview session is auto-created. Accepts an Idempotency-Key header to make retries safe.
Authorizations
API key authentication for the public API. Pass your API key as a Bearer token.
Headers
Unique key (e.g. a UUID v4) that makes this POST safe to retry: a repeated key replays the original response instead of creating a second resource.
Path Parameters
Body
Request body for POST /jobs/{job_id}/applications.
1 - 150Phone number in E.164 format (e.g. +16505551234, +66812345678).
1 - 20Your identifier for this application in your own system. Returned on reads and webhook events. Unique per job posting.
2551 - 1501Free-form JSON object of customer-submitted data. Max 64 KB serialized.
Optional https URL to the candidate's CV (PDF). Downloaded and processed asynchronously.
When to hold the interview (ISO 8601). Required when the job's interview-config schedule is enabled; must be omitted otherwise (a 409 is returned if provided when scheduling is off).
Response
Full application: adds custom_fields to the list shape.
The interview / insights / CV-evaluation sub-resources are reached via the
links block (each is its own typed endpoint), not inlined here.
The application's ID in the system that supplied it, in that system's own form. Unique per job posting and source.
applied- Appliedscreened- Screenedinterviewed- Interviewedshortlisted- Shortlistedhired- Hiredrejected- Rejected
applied, screened, interviewed, shortlisted, hired, rejected Lean interview pointer on an application (full result is its own sub-resource).

