Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Candidate Employments

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.

post/v3/candidate_employments

Request body

candidate_idinteger required

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

company_namestring required

Free-text name of the employer.

titlestring required

Free-text job title held at this employer.

start_datestring 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.

end_datestring 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.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
candidate_idinteger

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

company_namestring

Free-text name of the employer, as entered on the candidate's profile.

titlestring

Free-text job title held at this employer.

start_datestring date

Start date of this employment, as an ISO 8601 date. The Greenhouse UI displays only the month and year.

end_datestring date nullable

End date of this employment, as an ISO 8601 date. null indicates the employment is current (ongoing). The Greenhouse UI displays only the month and year.

latestboolean nullable

true when this is the candidate's most recent employment. Greenhouse maintains this flag automatically — the current job (end_date: null) wins, otherwise the entry with the latest end_date — and at most one employment per candidate has latest: true. Mirrors the company and title shown on the parent candidate record.