Create candidate employment

Add a new work history entry to a candidate's profile. candidate_id, company_name, title, and start_date are required; company_name and title are free-text strings (no custom-field option lookup is needed). Omit end_date to record the entry as the candidate's current job — Greenhouse will then recompute the latest flag across the candidate's employments, with the current job winning over any historical entries.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required

Id of the candidate (person) the employment entry belongs to.

string
required
length ≤ 255

Free-text name of the employer.

string
required
length ≤ 255

Free-text job title held at this employer.

date
required

Start date of this employment, as an ISO 8601 date (YYYY-MM-DD). Only the month and year are surfaced on the candidate profile.

date

End date of this employment, as an ISO 8601 date (YYYY-MM-DD). Omit when the candidate currently holds this job — Greenhouse treats an entry with no end_date as the candidate's current employment.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

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