This guide walks you through connecting your Lever account to Hatch. See this article for an overview of how the integration works.
Before you start
You'll need administrator access to Lever.
The connection is managed through Merge, a trusted integration partner. Hatch never stores your Lever credentials directly.
How to connect
In Hatch, go to Settings > Integrations.
Select Lever from the list of available integrations.
You'll be redirected to Lever to authorise the connection via OAuth. Review and approve the requested 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.
Lever API permissions
Required
Applications: Push candidates into your pipeline on apply; sync stage changes back to Hatch
Candidates: Create and update candidate records when applications are pushed
Offers: Read offer data associated with candidates
Activity feed: Post screening and application responses as candidate notes
Attachments: Access candidate files and resume data
Departments: Filter imported jobs based on department
Jobs: Import and sync job data for auto-posting
Job postings: Detect public job postings for auto-import
Job stages: Map Lever stages to Hatch stages for two-way sync (note: stages are defined at the org level in Lever, not per-job)
Offices: Import office/location metadata for jobs
Rejection reasons: Sync candidate rejection status and reasons back to Hatch
Scheduled interviews: Read interview data associated with candidates
Scorecards: Read feedback submitted against candidates
Screening questions: Import application form questions and candidate responses
Sources: Track candidate source attribution — all Hatch candidates are tagged with the "Hatch" source automatically
Users: Resolve recruiter assignments for imported jobs
Sending profiles
There are two ways to send candidates from Hatch to Lever, which you can configure in Settings > Integrations > Sending profiles.
Send on shortlist
Candidates are sent to Lever 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 Lever.
Note: applicants won't receive Hatch notifications for actions taken in Lever.
Send on apply (two-way sync)
Candidates are sent to Lever as soon as they apply. Actions in either Hatch or Lever are kept in sync. This requires you to map each Hatch stage to a corresponding stage in Lever:
Applications → syncs to New Applicant (fixed)
Shortlist → select a Lever stage (e.g. Phone screen)
Declined → syncs to Archived (fixed)
You'll also need to set a default archive reason, which is applied in Lever when a candidate is declined in Hatch (e.g. Underqualified). You can set a company-wide default in your account settings or a job specific default.
Importing and auto-posting jobs
You can import jobs from Lever 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 Lever 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 Lever careers site.
Need help?
Reach out to your Hatch contact or ask@hatch.team and we'll walk you through it.