This guide walks you through connecting your Workable account to Hatch. See this article for an overview of how the integration works.
Before you start
You'll need administrator access to Workable.
The connection is managed through Merge, a trusted integration partner. Hatch never stores your Workable credentials directly.
How to connect
In Hatch, go to Settings > Integrations.
Select Workable from the list of available integrations.
Follow the prompts to authenticate with your Workable 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.
Workable API permissions
Required
Applications: Push candidates into your pipeline on apply; sync stage changes back to Hatch
Attachments: Access candidate files and resume data
Candidates: Create and update candidate records when applications are pushed
Activity feed: Post screening and application responses as candidate notes
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 Workable stages to Hatch stages for two-way sync
Offers: Read offer data associated with candidates
Offices: Import office/location metadata for jobs
Rejection reasons: Sync candidate rejection status and reasons back to Hatch
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 Workable, which you can configure on a job level, or set defaults in Settings > Integrations > Sending profiles.
Send on shortlist
Candidates are sent to Workable 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 Workable.
Note: applicants won't receive Hatch notifications for actions taken in Workable.
Send on apply (two-way sync)
Candidates are sent to Workable as soon as they apply. Actions in either Hatch or Workable are kept in sync. This requires you to map each Hatch stage to a corresponding stage in Workable. Stage mapping can be set as a company-wide default and customised per job.
Applications → syncs to New Applicant (fixed)
Shortlist → select a Workable stage (e.g. Phone screen)
Declined → syncs to Disqualified (fixed)
You'll also need to set a default decline reason, which is applied in Workable when a candidate is declined in Hatch. 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 Workable 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 Workable 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 Workable 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 Workable partner.