Greenhouse

Use Greenhouse to manage recruiting through Harvest v3. The current block supports 50 operations covering candidates, applications, notes, attachments, tags, hiring teams, interviews, scorecards, offers, and reference data. Existing webhook triggers remain available.

Connect a Greenhouse account

Save your own Greenhouse API credential, then select it in the block. In Greenhouse, open Dev Center > API Credentials, create a Harvest V3 (OAuth) credential, and copy its client ID and client secret. On the credential's settings, enable the Harvest scopes for the operations your workflows use; the scopes listed below cover every operation. Sim obtains access tokens with the client credentials grant and gets a new one when it expires. Requests act as the integration service user Greenhouse creates with the credential. You do not need a redirect URI or a Sim-owned OAuth application, and a legacy Harvest API key cannot authenticate the new block.

Deployments that have Greenhouse partner OAuth credentials can also connect an account through consent. Complete consent with a Site Admin, which Greenhouse requires for list endpoints. A partner connection that has not refreshed within the provider's 14-day refresh-token lifetime must reconnect.

Upgrade existing workflows

The original API-key block remains as Greenhouse (Legacy) so existing workflows keep their saved configuration. New blocks use Harvest v3. Upgrade an existing block explicitly, select a Greenhouse credential, choose its operation again, and update input and output references before running it. The legacy integration is subject to Greenhouse's v1 availability; preserving a saved block does not extend provider support.

Harvest v3 returns applications, attachments, education, and employment through separate resources. Use their list operations and candidate or application filters to assemble a complete record. Single-record reads use the provider's ids filter. Do not assume the old embedded response structure survives the upgrade.

Pagination and changes

List operations return one page, its count, nextCursor, and hasMore. Set a page size from 1 to 500 and pass nextCursor into the next call until hasMore is false. A cursor carries the initial query, so other filters and page size are ignored while it is set. Date filters accept a JSON object such as {"gte":"2026-01-01T00:00:00Z"}; use either created_at or updated_at, not both.

For list operations, Job IDs uses comma-separated IDs. For prospect application creation, Job IDs uses a JSON array of integers. Created At takes a JSON date range on list operations, an ISO 8601 timestamp when creating an application, and a YYYY-MM-DD date when updating an application.

Partial reads leave unrequested fields as null, including collections. An explicit empty array means the collection is empty. Date-only filters, such as offer sent_on and starts_on, use YYYY-MM-DD bounds.

When updating candidate contact arrays, tags, or linked users, read the current candidate first and submit the complete desired array: supplied arrays replace their existing values. Unset inputs are omitted; custom-field entries may use null to clear a value. Creating an email note records an email in Greenhouse and does not send one. Application movement may trigger Greenhouse stage automation, and rejection can optionally send a rejection email. Move, hire, reject, and unreject operations return no provider fields on success.

See the Harvest v3 API reference, list filtering guide, and write migration guide for provider behavior.

OAuth scopes

Sim requests these scopes when someone connects a Greenhouse account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

SettingValue
Redirect URI<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/greenhouse
Environment variablesGREENHOUSE_CLIENT_ID, GREENHOUSE_CLIENT_SECRET
ScopeDescription
harvest:application_stages:listView Greenhouse application stages
harvest:applications:convert_to_candidateConvert prospects to candidates for Greenhouse applications
harvest:applications:createCreate Greenhouse applications
harvest:applications:destroyDelete Greenhouse applications
harvest:applications:hireMark Greenhouse applications as hired
harvest:applications:listView Greenhouse applications
harvest:applications:moveMove Greenhouse applications between stages or jobs
harvest:applications:rejectReject Greenhouse applications
harvest:applications:unrejectReverse Greenhouse application rejections
harvest:applications:updateUpdate Greenhouse applications
harvest:applied_candidate_tags:createApply Greenhouse tags to candidates
harvest:applied_candidate_tags:destroyRemove Greenhouse tags from candidates
harvest:applied_candidate_tags:listView Greenhouse applied candidate tags
harvest:attachments:createCreate Greenhouse attachments
harvest:attachments:destroyDelete Greenhouse attachments
harvest:attachments:listView Greenhouse attachments
harvest:candidate_educations:listView Greenhouse candidate education histories
harvest:candidate_employments:listView Greenhouse candidate employment histories
harvest:candidate_tags:createCreate Greenhouse candidate tags
harvest:candidate_tags:listView Greenhouse candidate tags
harvest:candidates:createCreate Greenhouse candidates
harvest:candidates:destroyDelete Greenhouse candidates
harvest:candidates:listView Greenhouse candidates
harvest:candidates:updateUpdate Greenhouse candidates
harvest:close_reasons:listView Greenhouse close reasons
harvest:custom_field_options:listView Greenhouse custom field options
harvest:custom_fields:listView Greenhouse custom fields
harvest:departments:listView Greenhouse departments
harvest:email_templates:listView Greenhouse email templates
harvest:interviews:listView Greenhouse interviews
harvest:job_hiring_managers:listView Greenhouse job hiring managers
harvest:job_interview_stages:listView Greenhouse job interview stages
harvest:job_owners:listView Greenhouse job owners
harvest:jobs:listView Greenhouse jobs
harvest:notes:createCreate Greenhouse notes
harvest:notes:listView Greenhouse notes
harvest:offers:listView Greenhouse offers
harvest:offices:listView Greenhouse offices
harvest:openings:listView Greenhouse openings
harvest:prospect_pool_stages:listView Greenhouse prospect pool stages
harvest:prospect_pools:listView Greenhouse prospect pools
harvest:referrers:listView Greenhouse referrers
harvest:rejection_reasons:listView Greenhouse rejection reasons
harvest:scorecards:listView Greenhouse scorecards
harvest:sources:listView Greenhouse sources
harvest:users:listView Greenhouse users

Use the block

Read and manage candidates, applications, notes, attachments, and tags with Harvest v3 OAuth. Retrieve jobs, hiring teams, interviews, scorecards, offers, and configuration resources with cursor pagination. Existing Greenhouse webhooks remain available.

Actions

Greenhouse List Candidates

Lists one page of candidates with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
last_activity_atjsonNoLast activity at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
custom_field_option_idnumberNoCustom field option ID
privatebooleanNoCandidate or custom-field privacy flag; for candidate listing, false excludes private candidates.
emailstringNoEmail
tagstringNoTag

Output

ParameterTypeDescription
candidatesarraycandidates on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ first_namestringFirst name
↳ last_namestringLast name
↳ preferred_namestringPreferred name
↳ companystringCompany
↳ titlestringTitle
↳ last_activity_atstringLast activity at (ISO 8601)
↳ privatebooleanCandidate or custom-field privacy flag; for candidate listing, false excludes private candidates.
↳ can_emailbooleanWhether the candidate consents to email communication.
↳ time_zonestringGreenhouse time-zone identifier (for example, eastern time (us & canada)).
↳ tagsarrayTags
↳ linked_user_idsarrayLinked user IDs
↳ phone_numbersarrayPhone numbers
↳ valuestringValue
↳ typestringType
↳ addressesarrayAddresses
↳ valuestringValue
↳ typestringType
↳ email_addressesarrayEmail addresses
↳ valuestringValue
↳ typestringType
↳ website_addressesarrayWebsite addresses
↳ valuestringValue
↳ typestringType
↳ social_media_addressesarraySocial media addresses
↳ valuestringValue
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Get Candidate

Retrieves one candidate by ID using the v3 list endpoint.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
first_namestringFirst name
last_namestringLast name
preferred_namestringPreferred name
companystringCompany
titlestringTitle
last_activity_atstringLast activity at (ISO 8601)
privatebooleanCandidate or custom-field privacy flag; for candidate listing, false excludes private candidates.
can_emailbooleanWhether the candidate consents to email communication.
time_zonestringGreenhouse time-zone identifier (for example, eastern time (us & canada)).
tagsarrayTags
linked_user_idsarrayLinked user IDs
phone_numbersarrayPhone numbers
↳ valuestringValue
↳ typestringType
addressesarrayAddresses
↳ valuestringValue
↳ typestringType
email_addressesarrayEmail addresses
↳ valuestringValue
↳ typestringType
website_addressesarrayWebsite addresses
↳ valuestringValue
↳ typestringType
social_media_addressesarraySocial media addresses
↳ valuestringValue
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse Create Candidate

Creates a candidate profile and optionally its first application.

Inputs and outputs

Input

ParameterTypeRequiredDescription
first_namestringYesFirst name
last_namestringYesLast name
preferred_namestringNoPreferred name
time_zonestringNoGreenhouse time-zone identifier (for example, eastern time (us & canada)).
companystringNoCompany
titlestringNoTitle
can_emailbooleanNoWhether the candidate consents to email communication.
phone_numbersarrayNoPhone numbers JSON array of objects with value, type. type: home, work, mobile, skype, other.
addressesarrayNoAddresses JSON array of objects with value, type. type: home, work, other.
email_addressesarrayNoEmail addresses JSON array of objects with value, type. type: personal, work, other.
website_addressesarrayNoWebsite addresses JSON array of objects with value, type. type: personal, company, portfolio, blog, other.
social_media_addressesarrayNoSocial media addresses JSON array of objects with value.
tagsarrayNoTags JSON array of string values.
linked_user_idsarrayNoLinked Greenhouse user IDs as a JSON array of integers.
custom_fieldsarrayNoJSON array of {name_key or custom_field_id, value}; use exactly one identifier per entry. Values follow the field type; null clears a value. JSON array of objects with name_key, custom_field_id, value.
applicationjsonNoOptional first application as JSON: {job_id, initial_stage_id?, source_id?, recruiter_id?, coordinator_id?, referrer_id?, created_at?, custom_fields?}, or {prospect:true, job_ids?, prospect_pool_id?, prospect_pool_stage_id?, prospect_owner_id?, prospective_department_id?, prospective_office_id?, source_id?, recruiter_id?, coordinator_id?, referrer_id?, created_at?, custom_fields?}.

Output

ParameterTypeDescription
candidatejsoncandidate created by this request
↳ idnumberGreenhouse resource ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ preferred_namestringPreferred name
↳ companystringCompany
↳ titlestringTitle
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ can_emailbooleanWhether the candidate consents to email communication.
↳ time_zonestringGreenhouse time-zone identifier (for example, eastern time (us & canada)).
↳ last_activity_atstringLast activity at (ISO 8601)
↳ privatebooleanCandidate or custom-field privacy flag; for candidate listing, false excludes private candidates.
↳ tagsarrayTags
↳ linked_user_idsarrayLinked user IDs
↳ phone_numbersarrayPhone numbers
↳ valuestringValue
↳ typestringType
↳ addressesarrayAddresses
↳ valuestringValue
↳ typestringType
↳ email_addressesarrayEmail addresses
↳ valuestringValue
↳ typestringType
↳ website_addressesarrayWebsite addresses
↳ valuestringValue
↳ typestringType
↳ social_media_addressesarraySocial media addresses
↳ valuestringValue
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
applicationjsonapplication created by this request
↳ idnumberGreenhouse resource ID
↳ referrer_idnumberReferrer ID
↳ source_idnumberSource ID
↳ agency_note_idnumberAgency note ID
↳ recruiter_idnumberRecruiter ID
↳ coordinator_idnumberCoordinator ID
↳ needs_decisionbooleanNeeds decision
↳ prospectbooleanProspect
↳ rejected_atstringRejected at (ISO 8601)
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ last_activity_atstringLast activity at (ISO 8601)
↳ stage_idnumberStage ID
↳ job_interview_stage_idnumberJob interview stage ID
↳ candidate_idnumberCandidate ID
↳ rejection_reason_idnumberRejection reason ID
↳ job_idnumberJob ID
↳ job_post_idnumberJob post ID
↳ statusstringStatus Allowed: rejected, hired, converted, in_process.
↳ stage_namestringStage name
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
↳ location_addressstringLocation address
↳ answersarrayAnswers
↳ questionstringQuestion
↳ answerstringAnswer
↳ prospective_job_idsarrayProspective job IDs

Greenhouse Update Candidate

Updates selected candidate fields. Read the current candidate first: supplied arrays replace the entire existing collection. Send the complete desired array, or [] to remove all entries.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID
first_namestringNoFirst name
last_namestringNoLast name
preferred_namestringNoPreferred name
time_zonestringNoGreenhouse time-zone identifier (for example, eastern time (us & canada)).
companystringNoCompany
titlestringNoTitle
is_privatebooleanNoRestrict candidate visibility to users with private-candidate access.
can_emailbooleanNoWhether the candidate consents to email communication.
phone_numbersarrayNoPhone numbers JSON array of objects with value, type. type: home, work, mobile, skype, other. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
addressesarrayNoAddresses JSON array of objects with value, type. type: home, work, other. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
email_addressesarrayNoEmail addresses JSON array of objects with value, type. type: personal, work, other. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
website_addressesarrayNoWebsite addresses JSON array of objects with value, type. type: personal, company, portfolio, blog, other. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
social_media_addressesarrayNoSocial media addresses JSON array of objects with value. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
tagsarrayNoTags JSON array of string values. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
linked_user_idsarrayNoLinked Greenhouse user IDs as a JSON array of integers. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.
custom_fieldsarrayNoJSON array of {name_key or custom_field_id, value}; use exactly one identifier per entry. Values follow the field type; null clears a value. JSON array of objects with name_key, custom_field_id, value. Read first and send the full desired collection; this replaces all existing entries. Use [] to clear it.

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
first_namestringFirst name
last_namestringLast name
preferred_namestringPreferred name
companystringCompany
titlestringTitle
last_activity_atstringLast activity at (ISO 8601)
privatebooleanCandidate or custom-field privacy flag; for candidate listing, false excludes private candidates.
can_emailbooleanWhether the candidate consents to email communication.
time_zonestringGreenhouse time-zone identifier (for example, eastern time (us & canada)).
tagsarrayTags
linked_user_idsarrayLinked user IDs
phone_numbersarrayPhone numbers
↳ valuestringValue
↳ typestringType
addressesarrayAddresses
↳ valuestringValue
↳ typestringType
email_addressesarrayEmail addresses
↳ valuestringValue
↳ typestringType
website_addressesarrayWebsite addresses
↳ valuestringValue
↳ typestringType
social_media_addressesarraySocial media addresses
↳ valuestringValue
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse Delete Candidate

Delete candidate using Greenhouse Harvest v3.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
messagestringDeletion confirmation returned by Greenhouse

Greenhouse List Applications

Lists one page of applications with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
job_idsstringNoJob IDs Comma-separated values (maximum 50).
prospective_job_idsstringNoProspective job IDs Comma-separated values (maximum 50).
job_post_idsstringNoJob post IDs Comma-separated values (maximum 50).
source_idsstringNoSource IDs Comma-separated values (maximum 50).
referrer_idsstringNoReferrer IDs Comma-separated values (maximum 50).
stage_idsstringNoStage IDs Comma-separated values (maximum 50).
job_interview_stage_idsstringNoJob interview stage IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
statusstringNoStatus Allowed: rejected, hired, converted, active.
stage_namestringNoStage name
custom_field_option_idnumberNoCustom field option ID
last_activity_atjsonNoLast activity at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
prospectbooleanNoFilter by prospect status: true for prospect applications, false for candidate applications. Omit to include both.

Output

ParameterTypeDescription
applicationsarrayapplications on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ agency_note_idnumberAgency note ID
↳ candidate_idnumberCandidate ID
↳ coordinator_idnumberCoordinator ID
↳ job_idnumberJob ID
↳ job_post_idnumberJob post ID
↳ recruiter_idnumberRecruiter ID
↳ referrer_idnumberReferrer ID
↳ rejection_reason_idnumberRejection reason ID
↳ source_idnumberSource ID
↳ stage_idnumberStage ID
↳ job_interview_stage_idnumberJob interview stage ID
↳ stage_namestringStage name
↳ statusstringStatus Allowed: rejected, hired, converted, in_process.
↳ needs_decisionbooleanNeeds decision
↳ prospectbooleanProspect
↳ rejected_atstringRejected at (ISO 8601)
↳ last_activity_atstringLast activity at (ISO 8601)
↳ location_addressstringLocation address
↳ answersarrayAnswers
↳ questionstringQuestion
↳ answerstringAnswer
↳ prospective_job_idsarrayProspective job IDs
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Get Application

Retrieves one application by ID using the v3 list endpoint.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
agency_note_idnumberAgency note ID
candidate_idnumberCandidate ID
coordinator_idnumberCoordinator ID
job_idnumberJob ID
job_post_idnumberJob post ID
recruiter_idnumberRecruiter ID
referrer_idnumberReferrer ID
rejection_reason_idnumberRejection reason ID
source_idnumberSource ID
stage_idnumberStage ID
job_interview_stage_idnumberJob interview stage ID
stage_namestringStage name
statusstringStatus Allowed: rejected, hired, converted, in_process.
needs_decisionbooleanNeeds decision
prospectbooleanProspect
rejected_atstringRejected at (ISO 8601)
last_activity_atstringLast activity at (ISO 8601)
location_addressstringLocation address
answersarrayAnswers
↳ questionstringQuestion
↳ answerstringAnswer
prospective_job_idsarrayProspective job IDs
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse Create Application

Creates a job application or prospect application for an existing candidate.

Inputs and outputs

Input

ParameterTypeRequiredDescription
source_idnumberNoSource ID
recruiter_idnumberNoRecruiter ID
coordinator_idnumberNoCoordinator ID
referrer_idnumberNoReferrer ID
created_atstringNoCreation time in ISO 8601 format
custom_fieldsarrayNoJSON array of {name_key or custom_field_id, value}; use exactly one identifier per entry. Values follow the field type; null clears a value. JSON array of objects with name_key, custom_field_id, value.
candidate_idnumberYesCandidate ID to create the application for.
job_idnumberNoJob ID
initial_stage_idnumberNoInitial stage ID
prospectbooleanNoWhether this is a prospect application. Set true to use prospect placement fields instead of job_id.
job_idsarrayNoJob IDs for a prospect as a JSON array of integers. Requires prospect=true.
prospect_pool_idnumberNoProspect pool ID
prospect_pool_stage_idnumberNoProspect pool stage ID
prospect_owner_idnumberNoProspect owner ID
prospective_department_idnumberNoProspective department ID
prospective_office_idnumberNoProspective office ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
agency_note_idnumberAgency note ID
candidate_idnumberCandidate ID
coordinator_idnumberCoordinator ID
job_idnumberJob ID
job_post_idnumberJob post ID
recruiter_idnumberRecruiter ID
referrer_idnumberReferrer ID
rejection_reason_idnumberRejection reason ID
source_idnumberSource ID
stage_idnumberStage ID
job_interview_stage_idnumberJob interview stage ID
stage_namestringStage name
statusstringStatus Allowed: rejected, hired, converted, in_process.
needs_decisionbooleanNeeds decision
prospectbooleanProspect
rejected_atstringRejected at (ISO 8601)
last_activity_atstringLast activity at (ISO 8601)
location_addressstringLocation address
answersarrayAnswers
↳ questionstringQuestion
↳ answerstringAnswer
prospective_job_idsarrayProspective job IDs
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse Update Application

Update application using Greenhouse Harvest v3.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID
source_idnumberNoSource ID
referrer_idnumberNoReferrer ID
recruiter_idnumberNoRecruiter ID
coordinator_idnumberNoCoordinator ID
prospect_pool_idnumberNoProspect pool ID
prospect_stage_idnumberNoProspect stage ID
rejected_atstringNoRejected at (YYYY-MM-DD)
created_atstringNoApplication creation date in YYYY-MM-DD format.
custom_fieldsarrayNoJSON array of {name_key or custom_field_id, value}; use exactly one identifier per entry. Values follow the field type; null clears a value. JSON array of objects with name_key, custom_field_id, value.

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
agency_note_idnumberAgency note ID
candidate_idnumberCandidate ID
coordinator_idnumberCoordinator ID
job_idnumberJob ID
job_post_idnumberJob post ID
recruiter_idnumberRecruiter ID
referrer_idnumberReferrer ID
rejection_reason_idnumberRejection reason ID
source_idnumberSource ID
stage_idnumberStage ID
job_interview_stage_idnumberJob interview stage ID
stage_namestringStage name
statusstringStatus Allowed: rejected, hired, converted, in_process.
needs_decisionbooleanNeeds decision
prospectbooleanProspect
rejected_atstringRejected at (ISO 8601)
last_activity_atstringLast activity at (ISO 8601)
location_addressstringLocation address
answersarrayAnswers
↳ questionstringQuestion
↳ answerstringAnswer
prospective_job_idsarrayProspective job IDs
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse Move Application

Moves or advances an application using its current stage as a guard; configured stage rules may send emails.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID
from_stage_idnumberYesCurrent application stage ID, required to guard against a stale move. Use stage_id from the application.
to_stage_idnumberNoTarget stage ID for a move within the current job. Use to_job_id when transferring to another job.
to_job_idnumberNoDestination job ID when transferring the application to another job.
email_from_user_idnumberNoUser ID to send any automated stage-transition emails from.

Output

No output fields.

Greenhouse Convert Prospect

Converts a prospect application into a new candidate application on a job already associated with the prospect.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID
job_idnumberYesJob ID already associated with the prospect or its pool.
to_job_interview_stage_idnumberNoTarget job interview stage ID; omit to use the job’s first stage.

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
agency_note_idnumberAgency note ID
candidate_idnumberCandidate ID
coordinator_idnumberCoordinator ID
job_idnumberJob ID
job_post_idnumberJob post ID
recruiter_idnumberRecruiter ID
referrer_idnumberReferrer ID
rejection_reason_idnumberRejection reason ID
source_idnumberSource ID
stage_idnumberStage ID
job_interview_stage_idnumberJob interview stage ID
stage_namestringStage name
statusstringStatus Allowed: rejected, hired, converted, in_process.
needs_decisionbooleanNeeds decision
prospectbooleanProspect
rejected_atstringRejected at (ISO 8601)
last_activity_atstringLast activity at (ISO 8601)
location_addressstringLocation address
answersarrayAnswers
↳ questionstringQuestion
↳ answerstringAnswer
prospective_job_idsarrayProspective job IDs
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse Reject Application

Rejects an application; optionally sends or schedules the configured rejection email.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID
rejection_reason_idnumberYesRejection reason ID
notesstringNoNotes
rejection_emailjsonNoOptional JSON object {send_email_at, email_template_id, email_from_user_id}; supplying it sends or schedules a rejection email.
custom_fieldsarrayNoJSON array of {name_key or custom_field_id, value}; use exactly one identifier per entry. Values follow the field type; null clears a value. JSON array of objects with name_key, custom_field_id, value.

Output

No output fields.

Greenhouse Unreject Application

Restores a rejected application to its previous stage and clears its rejection reason and notes.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID

Output

No output fields.

Greenhouse Hire Application

Marks an application hired and closes its opening; provide opening_id when the job has multiple open openings.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idnumberYesGreenhouse resource ID
start_datestringNoStart date (ISO 8601)
opening_idnumberNoOpening ID; required when hiring into a job with multiple open openings.
close_reason_idnumberNoClose reason ID

Output

No output fields.

Greenhouse Delete Application

Delete application using Greenhouse Harvest v3.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
messagestringDeletion confirmation returned by Greenhouse

Greenhouse List Jobs

Lists one page of jobs with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
opened_atjsonNoOpened at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
closed_atjsonNoClosed at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
requisition_idstringNoRequisition ID
department_idnumberNoDepartment ID
office_idnumberNoOffice ID
custom_field_option_idnumberNoCustom field option ID
confidentialbooleanNoConfidential
statusstringNoStatus Allowed: open, draft, closed.

Output

ParameterTypeDescription
jobsarrayjobs on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
↳ requisition_idstringRequisition ID
↳ notesstringNotes
↳ confidentialbooleanConfidential
↳ statusstringStatus Allowed: open, draft, closed.
↳ opened_atstringOpened at (ISO 8601)
↳ closed_atstringClosed at (ISO 8601)
↳ is_templatebooleanIs template
↳ copied_from_idnumberCopied from ID
↳ department_idnumberDepartment ID
↳ external_department_idstringExternal department ID
↳ office_idsarrayOffice IDs
↳ external_office_idsarrayExternal office IDs
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Get Job

Retrieves one job by ID using the v3 list endpoint.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
namestringName
requisition_idstringRequisition ID
notesstringNotes
confidentialbooleanConfidential
statusstringStatus Allowed: open, draft, closed.
opened_atstringOpened at (ISO 8601)
closed_atstringClosed at (ISO 8601)
is_templatebooleanIs template
copied_from_idnumberCopied from ID
department_idnumberDepartment ID
external_department_idstringExternal department ID
office_idsarrayOffice IDs
external_office_idsarrayExternal office IDs
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse List Job Interview Stages

Lists one page of job interview stages with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
job_idsstringNoJob IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
activebooleanNoActive

Output

ParameterTypeDescription
job_interview_stagesarrayjob interview stages on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ job_idnumberJob ID
↳ sort_ordernumberSort order
↳ namestringName
↳ activebooleanActive
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Application Stages

Lists one page of application stages with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
job_interview_stage_idsstringNoJob interview stage IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
currentbooleanNoCurrent

Output

ParameterTypeDescription
application_stagesarrayapplication stages on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ application_idnumberApplication ID
↳ job_interview_stage_idnumberJob interview stage ID
↳ entered_atstringEntered at (ISO 8601)
↳ exited_atstringExited at (ISO 8601)
↳ days_in_stagenumberDays in stage
↳ currentbooleanCurrent
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Job Hiring Managers

Lists one page of job hiring managers with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
user_idsstringNoUser IDs Comma-separated values (maximum 50).
job_idsstringNoJob IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
job_hiring_managersarrayjob hiring managers on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ user_idnumberUser ID
↳ job_idnumberJob ID
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Job Owners

Lists one page of job owners with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
user_idsstringNoUser IDs Comma-separated values (maximum 50).
job_idsstringNoJob IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
typestringNoType Allowed: sourcer, recruiter, coordinator.

Output

ParameterTypeDescription
job_ownersarrayjob owners on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ job_idnumberJob ID
↳ user_idnumberUser ID
↳ typestringType Allowed: sourcer, recruiter, coordinator.
↳ responsiblebooleanResponsible
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Openings

Lists one page of openings with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
job_idsstringNoJob IDs Comma-separated values (maximum 50).
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
close_reason_idsstringNoClose reason IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
opened_atjsonNoOpened at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
closed_atjsonNoClosed at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
custom_field_option_idnumberNoCustom field option ID
openbooleanNoOpen
opening_idstringNoFilter by the opening's identifier.

Output

ParameterTypeDescription
openingsarrayopenings on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ job_idnumberJob ID
↳ opened_atstringOpened at (ISO 8601)
↳ closed_atstringClosed at (ISO 8601)
↳ sort_ordernumberSort order
↳ opening_idstringOpening ID; required when hiring into a job with multiple open openings.
↳ application_idnumberApplication ID
↳ close_reason_idnumberClose reason ID
↳ target_start_onstringTarget start on (YYYY-MM-DD)
↳ openbooleanOpen
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Interviews

Lists one page of interviews with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
job_idsstringNoJob IDs Comma-separated values (maximum 50).
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
job_interview_idsstringNoJob interview IDs Comma-separated values (maximum 50).
organizer_idsstringNoOrganizer IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
starts_atjsonNoStarts at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
ends_atjsonNoEnds at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
all_day_start_onjsonNoAll day start on filter as JSON with gte, lte, gt, lt keys and YYYY-MM-DD dates, for example {"gte":"2026-01-01"}.
all_day_end_onjsonNoAll day end on filter as JSON with gte, lte, gt, lt keys and YYYY-MM-DD dates, for example {"gte":"2026-01-01"}.
external_event_idstringNoExternal event ID
statusstringNoStatus Allowed: to_be_scheduled, scheduled, awaiting_feedback, complete, skipped, collect_feedback, to_be_sent, sent, received.

Output

ParameterTypeDescription
interviewsarrayinterviews on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ job_idnumberJob ID
↳ application_idnumberApplication ID
↳ job_interview_idnumberJob interview ID
↳ starts_atstringStarts at (ISO 8601)
↳ ends_atstringEnds at (ISO 8601)
↳ locationstringLocation
↳ statusstringStatus Allowed: to_be_scheduled, scheduled, awaiting_feedback, complete, skipped, collect_feedback, to_be_sent, sent, received.
↳ organizer_idnumberOrganizer ID
↳ scheduled_atstringScheduled at (ISO 8601)
↳ all_day_start_onstringAll day start on (YYYY-MM-DD)
↳ all_day_end_onstringAll day end on (YYYY-MM-DD)
↳ external_event_idstringExternal event ID
↳ video_conferencing_urlstringVideo conferencing url
↳ availability_received_atstringAvailability received at (ISO 8601)
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Scorecards

Lists one page of scorecards with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
interview_kit_idsstringNoInterview kit IDs Comma-separated values (maximum 50).
submitter_idsstringNoSubmitter IDs Comma-separated values (maximum 50).
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
interviewer_idsstringNoInterviewer IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
interviewed_atjsonNoInterviewed at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
submitted_atjsonNoSubmitted at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
statusstringNoStatus Allowed: draft, complete.

Output

ParameterTypeDescription
scorecardsarrayscorecards on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ interview_kit_idnumberInterview kit ID
↳ interviewer_idnumberInterviewer ID
↳ interviewed_atstringInterviewed at (ISO 8601)
↳ notesstringNotes
↳ notes_with_tagsstringNotes with tags
↳ submitter_idnumberSubmitter ID
↳ candidate_ratingstringCandidate rating
↳ private_notesstringPrivate notes
↳ private_notes_with_tagsstringPrivate notes with tags
↳ statusstringStatus Allowed: draft, complete.
↳ public_notesstringPublic notes
↳ public_notes_with_tagsstringPublic notes with tags
↳ application_idnumberApplication ID
↳ submitted_atstringSubmitted at (ISO 8601)
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Offers

Lists one page of offers with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
job_idsstringNoJob IDs Comma-separated values (maximum 50).
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
opening_idsstringNoOpening IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
current_onlybooleanNoCurrent only
custom_field_option_idnumberNoCustom field option ID
statusstringNoStatus Allowed: Created, Accepted, Rejected, Deprecated.
resolved_atjsonNoResolved at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
sent_onjsonNoSent on filter as JSON with gte, lte, gt, lt keys and YYYY-MM-DD dates, for example {"gte":"2026-01-01"}.
starts_onjsonNoStarts on filter as JSON with gte, lte, gt, lt keys and YYYY-MM-DD dates, for example {"gte":"2026-01-01"}.

Output

ParameterTypeDescription
offersarrayoffers on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ versionnumberVersion
↳ application_idnumberApplication ID
↳ job_idnumberJob ID
↳ candidate_idnumberCandidate ID
↳ opening_idnumberOpening ID; required when hiring into a job with multiple open openings.
↳ statusstringStatus Allowed: Created, Accepted, Rejected, Deprecated.
↳ starts_onstringStarts on (YYYY-MM-DD)
↳ sent_onstringSent on (YYYY-MM-DD)
↳ resolved_atstringResolved at (ISO 8601)
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Notes

Lists one page of notes with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
user_idsstringNoUser IDs Comma-separated values (maximum 50).
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
typestringNoType Comma-separated values (maximum 50).
visibilitystringNoVisibility Allowed: admin_only_visible, privately_visible, publicly_visible.

Output

ParameterTypeDescription
notesarraynotes on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ candidate_idnumberCandidate ID
↳ application_idnumberApplication ID
↳ bodystringBody
↳ subjectstringSubject
↳ typestringType Allowed: NOTE, ACTIVITY, INTERVIEW, EMAIL, FOLLOW_UP, TAKE_HOME_TEST, LINKEDIN_NOTE, LINKEDIN_INMAIL, AVAILABILITY_REQUEST, MIGRATION_ERROR, TOUCHPOINT, FORM, FEEDBACK.
↳ user_idnumberUser ID
↳ email_fromstringComma-separated sender addresses for an EMAIL note
↳ email_tostringComma-separated recipient addresses for an EMAIL note
↳ email_ccarrayCC addresses for an EMAIL note
↳ import_hashstringImport hash
↳ body_with_tagsstringBody with tags
↳ visibilitystringVisibility Allowed: admin_only_visible, privately_visible, publicly_visible.
↳ email_attachment_file_namesstringEmail attachment file names
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Create Note

Creates a candidate note or activity entry, or logs an email without sending it.

Inputs and outputs

Input

ParameterTypeRequiredDescription
candidate_idnumberYesCandidate ID whose activity feed receives the note.
bodystringYesBody
subjectstringNoNote subject; required when note_type is EMAIL.
note_typestringYesNote classification: NOTE, ACTIVITY, or EMAIL. EMAIL logs an email and requires subject, email_from, email_to, and email_cc. Allowed: EMAIL, ACTIVITY, NOTE.
user_idnumberNoUser ID
email_fromarrayNoJSON array of sender addresses, required only when note_type is EMAIL. JSON array of string values.
email_toarrayNoJSON array of recipient addresses, required only when note_type is EMAIL. JSON array of string values.
email_ccarrayNoJSON array of CC addresses (may be empty), required only when note_type is EMAIL. JSON array of string values.
visibilitystringYesVisibility Allowed: admin_only, private, public.
application_idnumberNoApplication ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
candidate_idnumberCandidate ID
application_idnumberApplication ID
bodystringBody
subjectstringSubject
typestringType Allowed: NOTE, ACTIVITY, INTERVIEW, EMAIL, FOLLOW_UP, TAKE_HOME_TEST, LINKEDIN_NOTE, LINKEDIN_INMAIL, AVAILABILITY_REQUEST, MIGRATION_ERROR, TOUCHPOINT, FORM, FEEDBACK.
user_idnumberUser ID
email_fromstringComma-separated sender addresses for an EMAIL note
email_tostringComma-separated recipient addresses for an EMAIL note
email_ccarrayCC addresses for an EMAIL note
import_hashstringImport hash
body_with_tagsstringBody with tags
visibilitystringVisibility Allowed: admin_only_visible, privately_visible, publicly_visible.
email_attachment_file_namesstringEmail attachment file names

Greenhouse List Attachments

Lists one page of attachments with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
application_idsstringNoApplication IDs Comma-separated values (maximum 50).
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
typestringNoType Allowed: resume, cover_letter, take_home_test, offer_packet, offer_letter, signed_offer_letter, other, form_attachment, midfunnel_agreement, automated_agreement.

Output

ParameterTypeDescription
attachmentsarrayattachments on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ application_idnumberApplication ID
↳ candidate_idnumberCandidate ID
↳ typestringType Allowed: resume, cover_letter, take_home_test, offer_packet, offer_letter, signed_offer_letter, other, form_attachment, midfunnel_agreement, automated_agreement.
↳ filenamestringFilename
↳ urlstringProvider URL; attachment download URLs are temporary.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Create Attachment

Attaches a file to an application. A new resume or cover letter reclassifies the previous attachment of that type as other.

Inputs and outputs

Input

ParameterTypeRequiredDescription
application_idnumberYesApplication ID
filenamestringYesFilename
typestringYesType Allowed: resume, cover_letter, take_home_test, offer_packet, offer_letter, signed_offer_letter, other, form_attachment, midfunnel_agreement, automated_agreement.
contentstringNoBase64-encoded attachment content. Supply exactly one of content or url.
urlstringNoPublic attachment URL for Greenhouse to fetch. Supply exactly one of url or content.
visibilitystringNoVisibility Allowed: admin_only, private, public.

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
application_idnumberApplication ID
candidate_idnumberCandidate ID
typestringType Allowed: resume, cover_letter, take_home_test, offer_packet, offer_letter, signed_offer_letter, other, form_attachment, midfunnel_agreement, automated_agreement.
filenamestringFilename
urlstringProvider URL; attachment download URLs are temporary.

Greenhouse Delete Attachment

Delete attachment using Greenhouse Harvest v3.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
messagestringDeletion confirmation returned by Greenhouse

Greenhouse List Candidate Tags

Lists one page of candidate tags with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
candidate_tagsarraycandidate tags on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Create Candidate Tag

Create candidate tag using Greenhouse Harvest v3.

Inputs and outputs

Input

ParameterTypeRequiredDescription
namestringYesName

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
namestringName

Greenhouse List Applied Candidate Tags

Lists one page of applied candidate tags with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
candidate_tag_idsstringNoCandidate tag IDs Comma-separated values (maximum 50).
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
applied_candidate_tagsarrayapplied candidate tags on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ candidate_tag_idnumberCandidate tag ID
↳ candidate_idnumberCandidate ID
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Apply Candidate Tag

Apply candidate tag using Greenhouse Harvest v3.

Inputs and outputs

Input

ParameterTypeRequiredDescription
candidate_idnumberYesCandidate ID to tag.
candidate_tag_idnumberYesCandidate tag ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
candidate_tag_idnumberCandidate tag ID
candidate_idnumberCandidate ID

Greenhouse Remove Candidate Tag

Removes an applied tag by its applied_candidate_tags row ID, leaving the tag dictionary intact.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
messagestringDeletion confirmation returned by Greenhouse

Greenhouse List Candidate Educations

Lists one page of candidate educations with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
start_atjsonNoStart at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
end_atjsonNoEnd at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}.
latestbooleanNoLatest

Output

ParameterTypeDescription
candidate_educationsarraycandidate educations on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ candidate_idnumberCandidate ID
↳ school_name_custom_field_option_idnumberSchool name custom field option ID
↳ degree_custom_field_option_idnumberDegree custom field option ID
↳ discipline_custom_field_option_idnumberDiscipline custom field option ID
↳ start_atstringStart at (ISO 8601)
↳ end_atstringEnd at (ISO 8601)
↳ latestbooleanLatest
↳ start_date_monthnumberStart date month
↳ start_date_yearnumberStart date year
↳ end_date_monthnumberEnd date month
↳ end_date_yearnumberEnd date year
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Candidate Employments

Lists one page of candidate employments with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
candidate_idsstringNoCandidate IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
latestbooleanNoLatest

Output

ParameterTypeDescription
candidate_employmentsarraycandidate employments on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ candidate_idnumberCandidate ID
↳ company_namestringCompany name
↳ titlestringTitle
↳ start_datestringStart date (YYYY-MM-DD)
↳ end_datestringEnd date (YYYY-MM-DD)
↳ latestbooleanLatest
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Users

Lists one page of users with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
agency_idsstringNoAgency IDs Comma-separated values (maximum 50).
office_idsstringNoOffice IDs Comma-separated values (maximum 50).
department_idsstringNoDepartment IDs Comma-separated values (maximum 50).
linked_candidate_idsstringNoLinked candidate IDs Comma-separated values (maximum 50).
interviewer_tag_idsstringNoInterviewer tag IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
employee_idsstringNoEmployee IDs Comma-separated values (maximum 50).
custom_field_option_idnumberNoCustom field option ID
deactivatedbooleanNoDeactivated
primary_emailstringNoPrimary email
external_office_idstringNoExternal office ID
external_department_idstringNoExternal department ID
show_service_accountsbooleanNoShow service accounts

Output

ParameterTypeDescription
usersarrayusers on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ first_namestringFirst name
↳ last_namestringLast name
↳ primary_emailstringPrimary email
↳ job_titlestringJob title
↳ agency_idnumberAgency ID
↳ namestringName
↳ deactivatedbooleanDeactivated
↳ site_adminbooleanSite admin
↳ employee_idstringEmployee ID
↳ linked_candidate_idsarrayLinked candidate IDs
↳ office_idsarrayOffice IDs
↳ department_idsarrayDepartment IDs
↳ external_office_idsarrayExternal office IDs
↳ external_department_idsarrayExternal department IDs
↳ interviewer_tagsarrayInterviewer tags
↳ idnumberGreenhouse resource ID
↳ namestringName
↳ emailsarrayEmails
↳ custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse Get User

Retrieves one user by ID using the v3 list endpoint.

Inputs and outputs

Input

ParameterTypeRequiredDescription
idstringYesGreenhouse resource ID

Output

ParameterTypeDescription
idnumberGreenhouse resource ID
created_atstringCreation time in ISO 8601 format
updated_atstringLast update time in ISO 8601 format
first_namestringFirst name
last_namestringLast name
primary_emailstringPrimary email
job_titlestringJob title
agency_idnumberAgency ID
namestringName
deactivatedbooleanDeactivated
site_adminbooleanSite admin
employee_idstringEmployee ID
linked_candidate_idsarrayLinked candidate IDs
office_idsarrayOffice IDs
department_idsarrayDepartment IDs
external_office_idsarrayExternal office IDs
external_department_idsarrayExternal department IDs
interviewer_tagsarrayInterviewer tags
↳ idnumberGreenhouse resource ID
↳ namestringName
emailsarrayEmails
custom_fieldsjsonCustom fields keyed by field name, each containing name, type, and the dynamically typed value.

Greenhouse List Departments

Lists one page of departments with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
parent_idnumberNoParent ID
external_idstringNoExternal ID

Output

ParameterTypeDescription
departmentsarraydepartments on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
↳ parent_idnumberParent ID
↳ external_idstringExternal ID
↳ external_parent_idstringExternal parent ID
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Offices

Lists one page of offices with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
parent_idnumberNoParent ID
external_idstringNoExternal ID

Output

ParameterTypeDescription
officesarrayoffices on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
↳ parent_idnumberParent ID
↳ external_idstringExternal ID
↳ external_parent_idstringExternal parent ID
↳ locationstringLocation
↳ primary_in_house_contact_user_idnumberPrimary in house contact user ID
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Sources

Lists one page of sources with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
sourcesarraysources on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
↳ typejsonType
↳ idnumberGreenhouse resource ID
↳ namestringName
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Referrers

Lists one page of referrers with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
user_idsstringNoUser IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
referrersarrayreferrers on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ user_idnumberUser ID
↳ namestringName
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Rejection Reasons

Lists one page of rejection reasons with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
include_defaultsbooleanNoInclude defaults

Output

ParameterTypeDescription
rejection_reasonsarrayrejection reasons on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
↳ typejsonType
↳ idnumberGreenhouse resource ID
↳ keystringKey
↳ namestringName
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Close Reasons

Lists one page of close reasons with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
close_reasonsarrayclose reasons on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Prospect Pools

Lists one page of prospect pools with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
department_idsstringNoDepartment IDs Comma-separated values (maximum 50).
office_idsstringNoOffice IDs Comma-separated values (maximum 50).
job_idsstringNoJob IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
activebooleanNoActive

Output

ParameterTypeDescription
prospect_poolsarrayprospect pools on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ namestringName
↳ activebooleanActive
↳ descriptionstringDescription
↳ department_idsarrayDepartment IDs
↳ office_idsarrayOffice IDs
↳ job_idsarrayJob IDs
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Prospect Pool Stages

Lists one page of prospect pool stages with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
prospect_pool_idsstringNoProspect pool IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).

Output

ParameterTypeDescription
prospect_pool_stagesarrayprospect pool stages on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ prospect_pool_idnumberProspect pool ID
↳ namestringName
↳ sort_ordernumberSort order
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Custom Fields

Lists one page of custom fields with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
field_typestringNoField type Allowed: job, opening, standard, offer, compensation_frequency, candidate, referral_question, application, rejection_question, form, agency_question, user_attribute.
activebooleanNoActive
namestringNoName
name_keystringNoName key

Output

ParameterTypeDescription
custom_fieldsarraycustom fields on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ field_typestringField type Allowed: job, opening, standard, offer, compensation_frequency, candidate, referral_question, application, rejection_question, form, agency_question, user_attribute.
↳ sort_ordernumberSort order
↳ namestringName
↳ value_typestringValue type Allowed: short_text, long_text, yes_no, single_select, multi_select, currency, number, date, url, currency_range, number_range, user, linked, header, statement, attachment, rich_text.
↳ privatebooleanCandidate or custom-field privacy flag; for candidate listing, false excludes private candidates.
↳ requiredbooleanRequired
↳ require_approvalbooleanRequire approval
↳ trigger_new_versionbooleanTrigger new version
↳ activebooleanActive
↳ updated_by_idnumberUpdated by ID
↳ internal_typestringInternal type Allowed: employment_type, offer_documents, start_date, school_name, degree, discipline, offer_opening.
↳ expose_in_job_board_apibooleanExpose in job board api
↳ placeholderstringPlaceholder
↳ name_keystringName key
↳ descriptionstringDescription
↳ application_typestringApplication type Allowed: all_applications, candidate_applications, prospect_applications.
↳ api_onlybooleanApi only
↳ use_for_job_approvalsbooleanUse for job approvals
↳ use_for_offer_approvalsbooleanUse for offer approvals
↳ template_token_stringstringTemplate token string
↳ default_valuejsonDefault value
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Custom Field Options

Lists one page of custom field options with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
custom_field_idsstringNoCustom field IDs Comma-separated values (maximum 50).
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
activebooleanNoActive
custom_field_keystringNoCustom field key

Output

ParameterTypeDescription
custom_field_optionsarraycustom field options on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ custom_field_idnumberCustom field ID
↳ namestringName
↳ external_idstringExternal ID
↳ sort_ordernumberSort order
↳ activebooleanActive
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Greenhouse List Email Templates

Lists one page of email templates with cursor pagination and documented filters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
cursorstringNoOpaque nextCursor from the previous page. When set, all other filters and per_page are ignored.
per_pagenumberNoPage size from 1 to 500 (default 100). Each call retrieves one page.
idsstringNoIds Comma-separated values (maximum 50).
created_atjsonNoCreated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with updated_at.
updated_atjsonNoUpdated at filter as JSON with gte, lte, gt, lt keys and ISO 8601 values, for example {"gte":"2026-01-01T00:00:00Z"}. Cannot be combined with created_at.
fieldsstringNoComma-separated response field names. Omit to return all documented fields. Comma-separated values (maximum 50).
email_typestringNoEmail type
from_typestringNoFrom type Allowed: user_email, organization_email, my_email_address, inviter, organizer, not_applicable.

Output

ParameterTypeDescription
email_templatesarrayemail templates on this page
↳ idnumberGreenhouse resource ID
↳ created_atstringCreation time in ISO 8601 format
↳ updated_atstringLast update time in ISO 8601 format
↳ email_typestringEmail type
↳ subjectstringSubject
↳ bodystringBody
↳ user_idnumberUser ID
↳ namestringName
↳ descriptionstringDescription
↳ recipientsstringRecipients
↳ defaultbooleanDefault
↳ html_bodystringHtml body
↳ office_anywherebooleanOffice anywhere
↳ from_typestringFrom type Allowed: user_email, organization_email, my_email_address, inviter, organizer, not_applicable.
↳ cc_recruiterbooleanCc recruiter
↳ cc_coordinatorbooleanCc coordinator
countnumberNumber of records on this page
nextCursorstringOpaque cursor from the next Link header; null on the last page
hasMorebooleanWhether another page is available

Triggers

A trigger starts a workflow when a supported event occurs in this service.

Greenhouse Candidate Hired

Trigger workflow when a candidate is hired

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (hire_candidate)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ applicationobject
↳ idnumberApplication ID
↳ statusstringApplication status
↳ prospectbooleanWhether the applicant is a prospect
↳ applied_atstringWhen the application was submitted
↳ urlstringApplication URL in Greenhouse
↳ current_stageobject
↳ idnumberCurrent stage ID
↳ namestringCurrent stage name
↳ candidateobject
↳ idnumberCandidate ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ titlestringCurrent title
↳ companystringCurrent company
↳ email_addressesjsonEmail addresses
↳ phone_numbersjsonPhone numbers
↳ recruiterjsonAssigned recruiter
↳ coordinatorjsonAssigned coordinator
↳ jobsjsonAssociated jobs (array)
↳ sourceobject
↳ idnumberSource ID
↳ namestringSource name when provided by Greenhouse
↳ public_namestringPublic-facing source name when provided by Greenhouse
↳ offerobject
↳ idnumberOffer ID
↳ versionnumberOffer version
↳ starts_atstringOffer start date
↳ custom_fieldsjsonOffer custom fields
↳ custom_fieldsjsonApplication custom fields

Greenhouse Candidate Rejected

Trigger workflow when a candidate is rejected

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (reject_candidate)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ applicationobject
↳ idnumberApplication ID
↳ statusstringApplication status (rejected)
↳ prospectbooleanWhether the applicant is a prospect
↳ applied_atstringWhen the application was submitted
↳ rejected_atstringWhen the candidate was rejected
↳ urlstringApplication URL in Greenhouse
↳ current_stageobject
↳ idnumberStage ID where rejected
↳ namestringStage name where rejected
↳ candidateobject
↳ idnumberCandidate ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ email_addressesjsonEmail addresses
↳ phone_numbersjsonPhone numbers
↳ jobsjsonAssociated jobs (array)
↳ rejection_reasonjsonRejection reason object with id, name, and type fields
↳ rejection_detailsjsonRejection details with custom fields
↳ custom_fieldsjsonApplication custom fields

Greenhouse Candidate Stage Change

Trigger workflow when a candidate changes interview stages

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (candidate_stage_change)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ applicationobject
↳ idnumberApplication ID
↳ statusstringApplication status
↳ prospectbooleanWhether the applicant is a prospect
↳ applied_atstringWhen the application was submitted
↳ urlstringApplication URL in Greenhouse
↳ current_stageobject
↳ idnumberCurrent stage ID
↳ namestringCurrent stage name
↳ interviewsjsonInterviews in this stage
↳ candidateobject
↳ idnumberCandidate ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ titlestringCurrent title
↳ companystringCurrent company
↳ email_addressesjsonEmail addresses
↳ phone_numbersjsonPhone numbers
↳ jobsjsonAssociated jobs (array)
↳ sourceobject
↳ idnumberSource ID
↳ namestringSource name when provided by Greenhouse
↳ public_namestringPublic-facing source name when provided by Greenhouse
↳ custom_fieldsjsonApplication custom fields

Greenhouse Job Created

Trigger workflow when a new job is created

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (job_created)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ jobobject
↳ idnumberJob ID
↳ namestringJob title
↳ requisition_idstringRequisition ID
↳ statusstringJob status (open, closed, draft)
↳ confidentialbooleanWhether the job is confidential
↳ created_atstringWhen the job was created
↳ opened_atstringWhen the job was opened
↳ closed_atstringWhen the job was closed
↳ departmentsjsonAssociated departments
↳ officesjsonAssociated offices
↳ hiring_teamjsonHiring team (managers, recruiters, etc.)
↳ openingsjsonJob openings
↳ custom_fieldsjsonCustom field values

Greenhouse Job Updated

Trigger workflow when a job is updated

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (job_updated)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ jobobject
↳ idnumberJob ID
↳ namestringJob title
↳ requisition_idstringRequisition ID
↳ statusstringJob status (open, closed, draft)
↳ confidentialbooleanWhether the job is confidential
↳ created_atstringWhen the job was created
↳ opened_atstringWhen the job was opened
↳ closed_atstringWhen the job was closed
↳ departmentsjsonAssociated departments
↳ officesjsonAssociated offices
↳ hiring_teamjsonHiring team (managers, recruiters, etc.)
↳ openingsjsonJob openings
↳ custom_fieldsjsonCustom field values

Greenhouse New Application

Trigger workflow when a new application is submitted

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (new_candidate_application)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ applicationobject
↳ idnumberApplication ID
↳ statusstringApplication status
↳ prospectbooleanWhether the applicant is a prospect
↳ applied_atstringWhen the application was submitted
↳ urlstringApplication URL in Greenhouse
↳ current_stageobject
↳ idnumberCurrent stage ID
↳ namestringCurrent stage name
↳ candidateobject
↳ idnumberCandidate ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ titlestringCurrent title
↳ companystringCurrent company
↳ created_atstringWhen the candidate was created
↳ email_addressesjsonEmail addresses
↳ phone_numbersjsonPhone numbers
↳ tagsjsonCandidate tags
↳ jobsjsonAssociated jobs (array)
↳ sourceobject
↳ idnumberSource ID
↳ namestringSource name when provided by Greenhouse
↳ public_namestringPublic-facing source name when provided by Greenhouse
↳ answersjsonApplication question answers
↳ attachmentsjsonApplication attachments
↳ custom_fieldsjsonApplication custom fields

Greenhouse Offer Created

Trigger workflow when a new offer is created

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type (offer_created)
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadobject
↳ idnumberOffer ID
↳ application_idnumberAssociated application ID
↳ job_idnumberAssociated job ID
↳ user_idnumberUser who created the offer
↳ versionnumberOffer version number
↳ sent_onstringWhen the offer was sent
↳ resolved_atstringWhen the offer was resolved
↳ start_datestringOffer start date
↳ notesstringOffer notes
↳ offer_statusstringOffer status
↳ custom_fieldsjsonCustom field values

Greenhouse Webhook (Endpoint Events)

Trigger on whichever event types you select for this URL in Greenhouse. Sim does not filter deliveries for this trigger.

Configuration and outputs

Configuration

ParameterTypeRequiredDescription
secretKeystringNoWhen set, requests must include a valid Signature header (HMAC-SHA256). If left empty, the endpoint does not verify signatures—only use on a private URL you fully control.

Output

ParameterTypeDescription
actionstringThe webhook event type
applicationIdnumberApplication id when present (payload.application.id or flat payload.application_id on offers)
candidateIdnumberCandidate id when payload.application.candidate.id is present
jobIdnumberJob id from payload.job.id or flat payload.job_id when present
payloadjsonFull event payload