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
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
Importing jobs and sending profiles
You can import jobs from Greenhouse into Hatch from the job creation screen. Hatch pulls in the job title, description, and location automatically. Once you shortlist any candidates for this job, they'll automatically be sent to Greenhouse.
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 with a unified API key. Hatch does not store this API key as this is managed by Merge who are an official Greenhouse partner.