← Tools Reference

Greenhouse

Greenhouse integration (Productivity, Data). Imported from open-connector.

API key7 toolshttps://harvest.greenhouse.io/v1
GET
greenhouse_list_jobs
List Greenhouse jobs with optional status, department, and timestamp filters.

/jobs

12 parameters
ParamTypeRequiredDescription
perPageintegeroptionalMaximum number of records to return in one response.
pageintegeroptionalGreenhouse page number to request.
skipCountbooleanoptionalWhether to omit the last pagination link for faster list requests.
createdBeforestringoptionalReturn only records created before this ISO-8601 timestamp.
createdAfterstringoptionalReturn only records created at or after this ISO-8601 timestamp.
updatedBeforestringoptionalReturn only records updated before this ISO-8601 timestamp.
updatedAfterstringoptionalReturn only records updated at or after this ISO-8601 timestamp.
statusstringoptionalReturn only jobs with this status.
requisitionIdstringoptionalReturn only jobs matching this requisition ID.
openingIdstringoptionalReturn only jobs containing this opening ID.
departmentIdintegeroptionalReturn only jobs in this Greenhouse department.
externalDepartmentIdstringoptionalReturn only jobs in the department matching this external department ID.
GET
greenhouse_get_job
Retrieve one Greenhouse job by ID.

/jobs/{id}

1 parameter
ParamTypeRequiredDescription
idintegerrequiredThe job ID.
GET
greenhouse_list_candidates
List Greenhouse candidates with optional job, email, candidate ID, and timestamp filters.

/candidates

10 parameters
ParamTypeRequiredDescription
perPageintegeroptionalMaximum number of records to return in one response.
pageintegeroptionalGreenhouse page number to request.
skipCountbooleanoptionalWhether to omit the last pagination link for faster list requests.
createdBeforestringoptionalReturn only records created before this ISO-8601 timestamp.
createdAfterstringoptionalReturn only records created at or after this ISO-8601 timestamp.
updatedBeforestringoptionalReturn only records updated before this ISO-8601 timestamp.
updatedAfterstringoptionalReturn only records updated at or after this ISO-8601 timestamp.
jobIdintegeroptionalReturn only candidates who have applied to this job.
emailstringoptionalReturn only candidates with this email address.
candidateIdsarrayoptionalReturn only candidates with these IDs. Greenhouse accepts up to 50 candidate ID…
GET
greenhouse_get_candidate
Retrieve one Greenhouse candidate by ID.

/candidates/{id}

1 parameter
ParamTypeRequiredDescription
idintegerrequiredThe candidate ID.
GET
greenhouse_list_applications
List Greenhouse applications with optional candidate, job, and status filters.

/applications

6 parameters
ParamTypeRequiredDescription
perPageintegeroptionalMaximum number of records to return in one response.
pageintegeroptionalGreenhouse page number to request.
skipCountbooleanoptionalWhether to omit the last pagination link for faster list requests.
candidateIdintegeroptionalReturn only applications for this candidate.
jobIdintegeroptionalReturn only applications for this job.
statusstringoptionalReturn only applications with this Greenhouse status.
GET
greenhouse_get_application
Retrieve one Greenhouse application by ID.

/applications/{id}

1 parameter
ParamTypeRequiredDescription
idintegerrequiredThe application ID.
POST
greenhouse_add_candidate_note
Create a Greenhouse candidate activity feed note using an explicit On-Behalf-Of audit user.

/candidates/{candidateId}/activity_feed/notes

4 parameters
ParamTypeRequiredDescription
candidateIdintegerrequiredThe Greenhouse candidate ID that receives the note.
onBehalfOfUserIdintegeroptionalThe Greenhouse user ID supplied in the required On-Behalf-Of audit header.
bodystringoptionalThe note body to add to the candidate activity feed.
visibilitystringoptionalThe Greenhouse note visibility.