How do I connect our Greenhouse ATS?
Before you start
A Greenhouse Site Admin, or a user who can manage all of your organization's API credentials, must approve the connection.
To see who has admin access in Greenhouse, sign in and go to https://app2.greenhouse.io/in_house_contacts.
Greenhouse usually has a Wellfound source. If you deleted or renamed it, add a source named Wellfound in Greenhouse, so you can see which candidates come from Wellfound.
Connect Greenhouse
- In Wellfound, click the gear icon (Settings), then ATS Integration. You can also go to https://wellfound.com/recruit/ats.
-
Select Greenhouse.

-
On the Connect Greenhouse page, click Proceed to Greenhouse.com.

- Sign in to Greenhouse if it asks you to.
-
Look at the access that Wellfound requests, then approve it.

-
Greenhouse sends you back to Wellfound, and Wellfound starts to import your Greenhouse jobs.

Select the jobs to sync
- On Select Greenhouse jobs to sync, select the jobs to publish on Wellfound.
- Under Visa Sponsorship, select Yes if your company sponsors U.S. visas. If this is different for each role, select No and set it on each job later.
-
Select whether to Automatically import new jobs to Wellfound, then click Next.

- On Manage your existing Wellfound jobs, match the imported jobs to your current Wellfound jobs. To remove a job that you no longer hire for, click Remove job.
-
If you already have jobs on Wellfound, select whether to Send previous applicants and matches to Greenhouse. Then click Next: Review.

-
On Review your changes, check the list, then click Save Changes.

- On Add Job Board Integrations (optional), add a Job Board Integration to show your Greenhouse custom application questions to candidates. See: How do I add custom questions from Greenhouse ATS? If you do not need custom questions, click Next - I'm done.
- When you see Congratulations, you're now connected to Greenhouse!, your synced jobs are live on Wellfound.
Important:
- Add a salary range to each full-time or contract job that you sync. Jobs without a salary rank lower in search results and show a Missing salary tag. See: How do I add a salary or equity range for a job post?
Manage the integration
Click the gear icon (Settings), then ATS Integration. After the first sync, this opens the ATS Settings page. There, you can:
- See the connection status, and disconnect Greenhouse.
- Choose what Wellfound sends to Greenhouse: matches only, or matches and applicants.
- Turn Automatically import new jobs from Greenhouse on or off.
- Sync Greenhouse jobs that are not on Wellfound yet. Click Sync Jobs.
- Refresh your imported jobs now. Click Refresh listings. Jobs also sync from Greenhouse every 12 hours.
- Add Job Board Integrations.
If your connection still uses an API key, the page also shows a Reconnect button.

Did you connect with an API key before?
Greenhouse connections that use an API key do not sync now. On the ATS Settings page, you see the message "Your Greenhouse connection is disconnected because Greenhouse retired its previous API."
To sync again, go to the ATS Settings page and click Reconnect. Then approve the access in Greenhouse.
Permissions Wellfound asks for
Wellfound connects to Greenhouse Harvest v3 with OAuth. You do not select permissions one by one. When you approve the connection, Greenhouse shows the access that Wellfound asks for, and you approve all of it in one step.
Wellfound asks for this access:
- Jobs and job posts: to import your live job posts, departments, offices, locations, and salary ranges. Permissions: harvest:jobs:list, harvest:job_posts:list, harvest:job_post_locations:list, harvest:job_board_custom_locations:list, harvest:offices:list, harvest:departments:list, harvest:pay_input_ranges:list.
- Users: to find a Greenhouse admin user for the changes that Wellfound makes on your behalf. Permission: harvest:users:list.
- Sources: to find the Wellfound source and add it to the candidates and applications that Wellfound sends. Permission: harvest:sources:list.
- Candidates and applications: to create and update candidates and applications, and to read stage, status, hire, and rejection data back into Wellfound. Permissions: harvest:candidates:list, harvest:candidates:create, harvest:candidates:update, harvest:applications:list, harvest:applications:create, harvest:applications:update, harvest:rejection_details:list, harvest:rejection_reasons:list.
- Attachments and notes: to add resumes and Wellfound notes to Greenhouse records. Permissions: harvest:attachments:create, harvest:notes:create.
Optional: if you also add a Greenhouse Board Token and Job Board API key, Wellfound can send applications through the Greenhouse Job Board API and show your custom application questions.
What syncs between Greenhouse and Wellfound
From Greenhouse to Wellfound:
- Job title and description
- Job department, to set the job role on Wellfound
- Job locations, when the job is first imported
- Salary ranges, from pay input ranges or supported salary custom fields
- If the job is live, and when it changes
- Custom application questions, when you add a Job Board Integration
- Candidate stage and status (matched, hired, or rejected), with the rejection reason
From Wellfound to Greenhouse:
- Candidate name, email, current company, title, and location
- Wellfound profile URL, website, and social profile links
- Resume, as an attachment
- Cover letter, Wellfound notes, and the AI assessment link when there is one, as a note
- The Wellfound source on the application
- Tags such as Open To Remote and Requires US Visa Sponsorship, when the candidate answers your Greenhouse custom application questions
- The Greenhouse job that you select during the sync






