This guide walks you through connecting your Greenhouse account to Hatch. See this article for an overview of how the integration works.
Before you start
You'll need administrator access to Greenhouse.
Create a Hatch custom source in Greenhouse (Configure > Custom Options > Sources) to ensure candidates are correctly attributed.
The connection is managed through Merge, a trusted integration partner. Hatch never stores your Greenhouse credentials directly.
How to connect
In Hatch, go to Settings > Integrations.
Select Greenhouse from the list of available integrations.
Follow the prompts to authenticate with your Greenhouse credentials and grant permissions (see below).
Wait for the initial sync to complete. This can take up to a few hours for larger accounts.
Once connected, you'll see your connection status in Settings > Integrations.
Greenhouse API permissions
Required
Applications: Push candidates into your pipeline on apply; sync stage changes back to Hatch
Candidates: Create candidate records when applications are pushed
Offers: Read offer data associated with candidates
Activity feed: Post screening and application responses as candidate notes
Departments: Filter imported jobs based on department
Custom locations: Import location data for jobs
Jobs: Import and sync job data for auto-posting
Job posts: Detect public job postings for auto-import
Job stages: Map Greenhouse stages to Hatch stages for two-way sync (note: stages are configured per job in Greenhouse, with company-wide defaults available)
Job openings: Detect open roles for auto-import
Offices: Import office/location metadata for jobs
Rejection reasons: Sync candidate rejection status and reasons back to Hatch
Sources: Track candidate source attribution
User roles: Resolve recruiter assignments for imported jobs
Optional
Our integration doesn't currently use the following entities, but may be updated to in the future.
Tags
EEOC
Scorecards
Scheduled interviews
Email templates
Prospect pool
Tracking links
Custom fields
Custom field options
Close reasons
Education
Approvals
Sending profiles
There are two ways to send candidates from Hatch to Greenhouse, which you can configure on a job level, or set defaults in Settings > Integrations > Sending profiles.
Send on shortlist
Candidates are sent to Greenhouse when they're shortlisted in Hatch. This is a one-way sync — once a candidate is sent, Hatch will no longer manage their progress. All subsequent candidate communications are handled in Greenhouse.
Note: applicants won't receive Hatch notifications for actions taken in Greenhouse.
Send on apply (two-way sync)
Candidates are sent to Greenhouse as soon as they apply. Actions in either Hatch or Greenhouse are kept in sync. This requires you to map each Hatch stage to a corresponding stage in Greenhouse. Stage mapping can be set as a company-wide default and customised per job.
Applications → syncs to New Applicant (fixed)
Shortlist → select a Greenhouse stage (e.g. Phone screen)
Declined → syncs to Rejected (fixed)
Importing and auto-posting jobs
You can import jobs from Greenhouse manually from the job creation screen. Hatch pulls in the job details automatically.
You can also enable auto-posting, which automatically posts new jobs from Greenhouse on Hatch. When auto-posting is active, you can filter which jobs are imported by office and department. You'll also set a default job owner who will be marked as the hiring manager on Hatch.
All linked jobs will be closed automatically when it closes on your Greenhouse careers site.
Need help?
Reach out to your Hatch contact or support@hatch.team and we'll walk you through it. Hatch partners with Merge to support ATS integrations — Merge are an official Greenhouse partner.