Greenhouse
API actions for the Greenhouse integration.
Greenhouse
Manage recruiting workflows with Greenhouse's ATS.
Add candidate note
Add a note to a candidate's profile in Greenhouse.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
candidate_id | string | Yes | ID of the candidate |
note | string | Yes | Note content to add |
visibility | string | No | Note visibility (e.g., 'public', 'private') |
Response
{
"note": {
"body": "Great interview performance.",
"id": 11111,
"visibility": "public"
},
"note_id": "11111"
}Create candidate
Create a new candidate in Greenhouse.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
first_name | string | Yes | Candidate's first name |
last_name | string | Yes | Candidate's last name |
email | string | Yes | Candidate's email address |
job_id | string | No | Job ID to associate the candidate with |
phone | string | No | Candidate's phone number |
resume_url | string | No | URL to the candidate's resume |
linkedin_url | string | No | Candidate's LinkedIn profile URL |
Response
{
"candidate": {
"email": "jane.doe@example.com",
"first_name": "Jane",
"id": 67890,
"last_name": "Doe"
},
"candidate_id": "67890"
}Get job details
Retrieve detailed information about a specific job.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id | string | Yes | Unique identifier of the job |
Response
{
"job": {
"departments": [
{
"id": 1,
"name": "Engineering"
}
],
"id": 12345,
"name": "Software Engineer",
"status": "open"
}
}List candidates
Retrieve candidates from Greenhouse with optional filters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id | string | No | Filter candidates by job ID |
email | string | No | Filter candidates by email address |
Response
{
"candidates": [
{
"email": "jane.doe@example.com",
"first_name": "Jane",
"id": 67890,
"last_name": "Doe"
}
],
"count": 1
}List jobs
Retrieve all job postings from Greenhouse.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter jobs by status (e.g., 'open', 'closed') |
updated_after | string | No | Filter jobs updated after this date (ISO 8601 format) |
Response
{
"count": 1,
"jobs": [
{
"id": 12345,
"name": "Software Engineer",
"status": "open"
}
]
}Move application stage
Move a candidate's application to a different stage in the pipeline.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
application_id | string | Yes | ID of the application to move |
to_stage_id | string | Yes | ID of the target stage |
reason | string | No | Reason for the stage transition |
Response
{
"application_id": "99999",
"stage": "22222"
}