Skip to main content

Greenhouse

Comprehensive Greenhouse ATS connector for managing candidates, jobs, applications, scorecards, and recruiting workflows.

What you can ask​

  • List candidates in the On-site stage for the Senior Engineer role, sorted by interview date.
  • Find offers extended in the last 30 days that haven't been accepted yet.
  • Pull a breakdown of candidates by source for Q1 hires.

Set up​

Greenhouse connects with credentials from your Greenhouse account. Have these values ready:

  • Client ID
  • Client secret
  1. Go to Organization > Connectors and find Greenhouse.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Greenhouse offers 71 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (29)​

View and search information without changing it.

ToolWhat it does
check_hire_readinessValidate application meets all hiring prerequisites.
discover_custom_and_required_fieldsShow the required, recommended and optional fields, plus org custom fields, for creating a candidate, job, application, department, office or user.
get_applicationGet one application by ID: candidate ID, job ID, current stage, status, source, recruiter and coordinator IDs and dates.
get_application_scorecardsList the scorecards for one application: overall rating (strong_yes to definitely_not), status, interviewer and submitted date.
get_candidateGet a candidate profile by ID: name, contacts, tags, custom fields, timestamps.
get_departmentRetrieve detailed information about a specific department by ID including department name, parent department, child departments, external ID, and complete hierarchical relationships.
get_jobGet one job by ID: name, status, requisition ID, department ID, office IDs, custom fields and dates.
get_job_approval_flowsGet a job's approval flows: approval type (e.g. offer_candidate), status (pending or approved), whether approval is sequential, and dates.
get_job_stagesList the interview stages of one job (job_id) or several (job_ids) in pipeline order, each with its interview slots and their job_interview_id, which create_interview needs.
get_officeRetrieve detailed information about a specific office by ID including office name, physical location, primary contact user, parent office, child offices, external ID, and complete hierarchical relationships.
get_scorecardGet one interview scorecard with the overall rating, notes, each interview question with the interviewer's answer, and each attribute rating (for example a skill) with its note.
get_scorecard_summaryCount one application's scorecards: total, submitted, and how many of each overall recommendation (strong_yes, yes, no, definitely_not, no_decision).
get_userGet one Greenhouse user by ID: name, primary email, employee ID, site admin and deactivated flags, linked candidate IDs and dates.
get_user_permissionsGet whether a Greenhouse user is a site admin and whether they are deactivated.
list_applicationsList applications.
list_candidatesList candidates, newest first.
list_close_reasonsList all reasons available for closing job openings to track why positions are no longer active (e.g., 'Hire - New Headcount', 'Position Eliminated', 'Filled Internally', 'Budget Frozen').
list_custom_fieldsList custom field definitions for every object type: name, type, whether required, and options for dropdowns.
list_departmentsList all departments in the organization including department names, IDs, parent-child relationships, external IDs, and child department hierarchies.
list_interviewsList scheduled interviews.
list_job_openingsList a job's openings (headcount slots): opening ID, external opening_id, open or closed, opened and closed dates, close reason and the application that filled it.
list_jobsList jobs, newest first.
list_officesList offices with ID, name, location text, parent and child offices, primary contact user ID and external ID.
list_reject_reasonsList rejection reasons with IDs, names and type (We rejected them, They rejected us, ...).
list_scorecardsList interview scorecards across all applications: overall rating, status, interviewer, application and dates.
list_sourcesList candidate sources (e.g. LinkedIn, Referral, Career Site) with IDs and types. Use these IDs for source_id when creating candidates or applications.
list_tagsList every candidate tag with ID and name.
list_usersList Greenhouse users (recruiters, hiring managers, admins) with ID, name, email, site admin and deactivated flags.
validate_credentialValidate Greenhouse credentials.

Write (15)​

Create or send data.

ToolWhat it does
add_application_noteAdd a note anchored to one application: a NOTE, an ACTIVITY entry, or a logged EMAIL (needs subject and email_from/to/cc). visibility is public, private or admin_only.
add_attachmentAttach a file (resume, cover letter, take-home test, offer document, other) to an application, as base64 content or a public url (exactly one).
add_candidate_educationAdd an education entry to a candidate: school, degree and discipline by name (matched to the org's option lists) or option ID, plus dates.
add_candidate_employmentAdd a work-history entry (company, title, start date, optional end date; no end date means current job) to a candidate.
add_candidate_noteAdd a candidate-level note: a NOTE, an ACTIVITY entry, or a logged EMAIL (needs subject and email_from/to/cc). visibility is public, private or admin_only.
add_candidate_tagsAdd tags to a candidate by tag name.
create_applicationCreate an application for an existing candidate: on a job (job_id), or a prospect (prospect true, optional job_ids and pool).
create_candidateCreate a candidate (first_name and last_name required) with contacts, tags and custom fields, and optionally their first application in the same call: application.job_id for a job, or application.prospect true for a prospect.
create_departmentCreate a department.
create_interviewRecord an already-scheduled interview on an application.
create_jobCreate a job by copying a template job (template_job_id), which supplies stages, departments and offices.
create_job_openingAdd openings (headcount slots) to a job.
create_officeCreate an office.
create_userCreate a Greenhouse user with first_name, last_name and email.
invite_userCreate a Greenhouse user and send them an invitation email.

Delete or overwrite (27)​

Remove or replace existing data.

ToolWhat it does
advance_applicationAdvance an application to the next interview stage, or to to_stage_id / to_stage_name on the same job. from_stage_id is read automatically when omitted.
anonymize_candidateErase selected personal data groups from a candidate (e.g. full_name, email_addresses, phone_numbers, attachments, notes) for privacy requests, keeping hiring activity for reporting.
convert_prospectConvert a prospect application into a candidate application on a job.
delete_applicationPermanently delete one application with its stages, scorecards and rejection and prospect details.
delete_attachmentPermanently delete an attachment from its application; deleting a resume also clears its resume score.
delete_candidatePermanently delete a candidate with all their applications, attachments, scorecards and notes.
delete_candidate_educationDelete one education entry from a candidate.
delete_candidate_employmentDelete one work-history entry from a candidate.
delete_interviewDelete an interview, with its panel, in-progress scorecards and reminders.
disable_userDeactivate a Greenhouse user so they cannot sign in; their history stays.
enable_userReactivate a deactivated Greenhouse user so they can sign in again.
hire_applicationMark an application hired and fill an opening on its job.
merge_candidatesMerge a duplicate candidate into a primary one.
move_applicationMove an application to any stage, forward or back (to_stage_id or to_stage_name), or onto another job (to_job_id). from_stage_id is read automatically when omitted.
reject_applicationReject an active application with a reason, optional internal note, custom fields and a templated rejection email (template by ID or name, now or scheduled).
remove_candidate_tagsRemove tags from a candidate by tag name.
transfer_applicationTransfer an application to a different job, optionally into a stage on that job (target_stage_id or target_stage_name; defaults to the first stage).
unreject_applicationRestore rejected application to active status.
update_applicationUpdate an application's source, referrer, recruiter, coordinator, prospect pool or stage, dates or custom fields.
update_application_rejectionChange the rejection reason or rejection-question answers of an already-rejected application without changing its rejection date.
update_candidateUpdate a candidate's name, title, company, contacts, time zone, privacy, tags, linked users or custom fields.
update_departmentUpdate an existing department's information including name, parent department relationship, and external ID.
update_interviewChange an interview's start/end time, location, video link, external_event_id or panel.
update_jobUpdate a job's name, requisition ID, notes, departments, offices, confidentiality or custom fields.
update_job_openingUpdate a job opening: close it (status 'closed' plus an optional close_reason_id from list_close_reasons), reopen it (status 'open'), or change its external opening_id or target start date.
update_officeUpdate an existing office's information including name, location, primary contact user, parent office relationship, and external ID.
update_userUpdate an existing Greenhouse user's information including first_name, last_name, email, employee_id, and linked_candidate_ids.
⌘J