Partner APIJobs

Create a job from a template

Creates a job in the organization from a screening template, with optional title, location, and pay-range overrides. The job’s screening questions come from the template and are read-only through the Partner API.

Authentication

AuthorizationBearer
Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Path parameters

org_idstringRequired

Organization ID (org_...).

Headers

Idempotency-KeystringOptional<=255 characters

Unique key (e.g. a UUID) making this POST safe to retry. Replays within 24 hours return the original response without repeating side effects.

Request

This endpoint expects an object.
template_idstringRequired

Screening template to create the job from (see GET /templates).

titlestringOptional
Override the template's default job title.
locationobjectOptional

City/state/ZIP location.

pay_rangeobjectOptional
Pay range advertised for the job.

Response

Job created.
idstringOptional

Job ID (job_...).

org_idstringOptional
template_idstringOptional
Template the job was created from.
titlestringOptional
locationobjectOptional

City/state/ZIP location.

pay_rangeobjectOptional
Pay range advertised for the job.
statusenumOptional
screening_questionslist of objectsOptional

Read-only summary of the questions asked on screenings for this job, including knockout flags.

created_atdatetimeOptional
updated_atdatetimeOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error