Greenhouse Recruiting

18 min

Greenhouse Recruiting is an applicant tracking system and recruiting software designed to help businesses manage their hiring process from sourcing to onboarding. With the Greenhouse Recruiting app in Make, you can manage the applications, candidates, prospects, jobs, job posts, offers, approval flows, and notes in your Greenhouse Recruiting account.

The Greenhouse Recruiting app is available on the Enterprise plan.

Make currently supports Greenhouse Recruiting. Greenhouse Onboarding is unsupported at this time.

To get started with Greenhouse Recruiting, create an account at greenhouse.com.

Greenhouse Recruiting: The account setting up the integration must have Developer Permissions in Greenhouse Recruiting.

Create the connection in Make using Greenhouse OAuth

To create the connection:

Optional: In the Connection name field, enter a name for the connection.

In Additional scopes, select any scopes your scenario needs.

Optional: To use your Greenhouse Recruiting Client ID and Client Secret in Advanced settings:

To obtain OAuth app approval from Greenhouse Partner Support, you must have a signed Greenhouse partnership agreement.

Contact Greenhouse Partner Support to approve your OAuth app at [email protected] and provide the following redirect URI: https://www.make.com/oauth/cb/greenhouse2. Once approved, Greenhouse sends you a Client ID and Client Secret.

Toggle Advanced settings and enter your Client ID and Client Secret.

Click Save.

If prompted, authenticate your account and confirm access.

Create the connection in Make using Greenhouse OAuth (Client Credentials)

Greenhouse Recruiting also supports a client credentials connection. Use this connection type for server-to-server integrations that don't need a user to sign in or grant consent.

This connection type requires Harvest v3. Greenhouse is retiring Harvest v1 and v2.

To create the connection:

Click Configure > Dev Center.

Click API Credential Management.

Click Create new API key.

Set the API Type to Harvest v3 (OAuth).

Click Manage Scopes and select only the scopes the modules in your scenario require.

Copy the Client ID and Client Secret.

The Client Secret is shown only once. Store it in a safe place before you continue.

Click Create a connection.

Optional: In the Connection name field, enter a name for the connection.

In Client ID field, paste the Client ID you copied earlier.

In Client Secret field, paste the Client Secret you copied earlier.

Optional: In the On behalf of User ID field, enter a numeric Greenhouse user ID.

Leave empty to use the Integration Service User attached to the credential. List endpoints require a user with Site Admin permissions. Find the ID in Configure > Users (the number in the user URL) or in a Users Excel export.

Click Save.

You have now created the connection. You can now edit your scenario and add more Greenhouse Recruiting modules. If your connection requires reauthorization at any point, follow the connection renewal steps here.

Modules

Application

Candidate

Job

Other

Add a candidate note

Module name: Add a Candidate Note → Add a candidate note

Input changes: none.

Output changes:

Field path	Before (API V2)	Now (API V3)
user	Nested user object (id, first_name, last_name, name, employee_id)	Removed — replaced by flat user_id (uinteger); map user.id → user_id
private	Boolean	Removed
visiblity	Text (legacy typo field)	Removed

Add application to candidate

Module name: Add Application to Candidate → Add application to candidate

Input changes:

Change	Before (API V2)	Now (API V3)
Removed attachments	Array with type + upload by URL/file (filename, url/content, content_type)	Field removed — upload via Add attachment to application
Referrer ID value type	referrer.type = id → value was text	Value is uinteger

Output changes: none breaking.

Add application to prospect

Module name: Add Application to Prospect → Add application to prospect

Input changes:

Change	Before (API V2)	Now (API V3)
Referrer ID value type	referrer.type = id → value was text	Value is uinteger
prospect_owner_id type	Text	uinteger

Output changes:

Field path	Before (API V2)	Now (API V3)
Nested objects (location, source, credited_to, jobs, current_stage, prospective_department, prospective_office, prospect_detail)	Nested objects	Removed — replaced by flat IDs (source_id, referrer_id, recruiter_id, coordinator_id, stage_id, stage_name, job_interview_stage_id)
prospective_job_ids	Nested structure	Flat array
location_address	Nested location	Flat text
applied_at	Present	Removed
answers	Untyped array	Array of { question, answer }

Add attachment to application

Module name: Add Attachment to Application → Add attachment to application

Input changes:

Change	Before (API V2)	Now (API V3)
Removed content_type	Optional under URL and file upload	Removed

Output changes:

Field path	Before (API V2)	Now (API V3)
content_type	Present	Removed

Add attachment to candidate

Module name: Add Attachment to Candidate → Add attachment to candidate

Input changes:

Change	Before (API V2)	Now (API V3)
Required application_id	Not required (attach directly to candidate)	Required — Harvest v3 attaches files to an application
Removed content_type	Optional under URL and file upload	Removed

Output changes:

Field path	Before (API V2)	Now (API V3)
content_type	Present	Removed

Create a candidate

Module name: Create a Candidate → Create a candidate

Input changes:

Change	Before (API V2)	Now (API V3)
Removed applications[].attachments	Could upload attachments while creating	Removed — use attachment modules after create
Removed activity_feed_notes	Could send notes on create	Removed — use Add a candidate note

Output changes:

Field path	Before (API V2)	Now (API V3)
applications[]	Array of nested application objects	Replaced by a single application collection with flat IDs (stage_id, job_id, source_id, ...); map application.id instead of applications[1].id

Create a prospect

Module name: Create a Prospect → Create a prospect

Input changes: none.

Output changes:

Field path	Before (API V2)	Now (API V3)
Output shape	Flat candidate fields at root + applications[]	Structured as candidate + application collections — remap root fields to candidate.* and use application.* instead of applications[]
photo_url / attachments / application_ids	Present	Removed
recruiter / coordinator objects	Present	Replaced by IDs under application
educations / employments	Present	Removed from this output contract

Get a job post

Module name: Get a Job Post → Get a job post

Input changes: none.

Output changes

Field path	Before (API V2)	Now (API V3)
questions[].type	Text	Removed — replaced by questions[].answer_type
questions[].values	Array of { value:number, label }	Removed — replaced by questions[].options (array of { label, value:text })

List approval flows

Module name: List Approval Flows → List approval flows

Input changes: none.

Output changes

Field path	Before (API V2)	Now (API V3)
approver_groups	Nested groups + approvers	Removed
requested_by_user_id	Present	Removed — replaced by requested_by_id

Search candidates

Module name: Search Candidates → Search candidates

Input changes:

Change	Before (API V2)	Now (API V3)
Removed job_id	Optional filter	Removed

Output changes:

Field path	Before (API V2)	Now (API V3)
applications	Nested applications array	Removed
attachments / application_ids / photo_url	Present	Removed
recruiter / coordinator objects	Present	Removed
educations / employments	Present	Removed
is_private	Boolean	Renamed to private
last_activity	Date	Renamed to last_activity_at
Custom fields	Empty collections	Now loaded from your Greenhouse account

Search job posts

Module name: Search Job Posts → Search job posts

Input changes: none.

Output changes: same question-schema shift as Get a job post — questions[].type / questions[].values replaced by questions[].answer_type / questions[].options.

Search jobs

Module name: Search Jobs → Search jobs

Input changes:

Change	Before (API V2)	Now (API V3)
Removed opening_id	Present	Removed
Removed external_department_id	Present	Removed
Removed external_office_id	Present	Removed

Output changes: none breaking.

Update a candidate

Module name: Update a Candidate → Update a candidate

Input changes:

Change	Before (API V2)	Now (API V3)
Removed applications	Could update embedded application payload (job_id, initial_stage_id, source_id, referrer, attachments)	Removed
Removed activity_feed_notes	Could send notes on update	Removed — use Add a candidate note

Output changes: none breaking.

Migration guide

If your scenario uses Greenhouse v1.

Update the connection — create/select a greenhouse2 connection and attach it to each migrated module.

Replace removed inputs

Attachments: stop using applications[].attachments / inline attachments; use Add attachment to application or Add attachment to candidate (with required application_id).

Notes: stop using activity_feed_notes on create/update; use Add a candidate note.

Search filters: remove job_id from Search candidates; remove opening_id, external_department_id, external_office_id from Search jobs.

Fix output references

Old path (v1)	New path (v2)	Modules
user.id	user_id	Add a candidate note
source.id / nested source	source_id	Add application to prospect
current_stage.*	stage_id / stage_name	Add application to prospect
applications[1].id	application.id	Create a candidate
Root candidate fields	candidate.*	Create a prospect
applications[]	application	Create a prospect
is_private	private	Search candidates
last_activity	last_activity_at	Search candidates
requested_by_user_id	requested_by_id	List approval flows
questions[].type / questions[].values	questions[].answer_type / questions[].options	Get / Search job posts
content_type (attachment output)	— (removed)	Attachment modules

Retype referrer / owner IDs — where referrer value / prospect_owner_id were free text, map numeric IDs (uinteger).

Re-test webhook payloads on the Watch modules after migrating the connection.

Greenhouse Recruiting

Create the connection in Make﻿ using Greenhouse OAuth

Create the connection in Make﻿ using Greenhouse OAuth (Client Credentials)

Modules

Application

Watch applications

Search applications

Add application to prospect

Add application to candidate

Add attachment to application

Candidate

Watch candidates

Search candidates

Create a prospect

Create a candidate

Update a candidate

Add a candidate note

Add attachment to candidate

Job

Watch jobs

Watch job posts

Watch offers

Search jobs

Search job posts

List approval flows

Get a job

Get a job post

Other

Make a Harvest API call

Migration from API V2 to V3

Add a candidate note

Add application to candidate

Add application to prospect

Add attachment to application

Add attachment to candidate

Create a candidate

Create a prospect

Get a job post

List approval flows

Search candidates

Search job posts

Search jobs

Update a candidate

Migration guide

Create the connection in Make using Greenhouse OAuth

Create the connection in Make using Greenhouse OAuth (Client Credentials)