Enabling the Greenhouse-Clinch Integration
This guide will walk you through the process of integrating your Greenhouse account with Clinch Talent.
1. Reading Jobs from Greenhouse into Clinch
In order to import jobs from Greenhouse the jobs must be accessible from a public jobs board.
In Greenhouse, you are able to make a job live without it being pushed to any other 3rd party source (i.e. only someone with that link will see the job). To make a job Live, click on the Job then select "Job Setup > Job Post > Get Started". Once you complete the Job Post, click on the and job then click "Job Setup > Job Post > Switch the Job from Off to Live" (screenshot below).
Generating a "Partner" API Key
Integrating Greenhouse with Clinch Talent is easy. You can start by navigating to the integrations page (Settings > ATS Integration) and clicking on the Greenhouse logo.
In your Clinch account, paste the API key into the Partner API Key field. You can find your company code by looking at the Greenhouse Job Board documentation. By inspecting the urls that begin with boards.greenhouse.io at the top of page, you can find the code. The url is of the form
https://boards.greenhouse.io/<company_code>. So if your url is
https://boards.greenhouse.io/acmelimited then your company code is
In your Clinch Talent account, click 'save' on the ATS Integration Settings page, and you will be brought to the job import history page. Click the 'Sync' button to import your jobs from Greenhouse.
2. Reading Candidate Statuses from Greenhouse into Clinch
Generating a "Harvest" API Key
1) Go to https://app.greenhouse.io/configure/dev_center/credentials
2) Click "Create new API key". Description is "Clinch Harvest", Type is "Harvest"
3) You'll be asked to give us permissions to certain parts of your account. We currently require permissions to 7 areas:
GET: Retrieve Candidate
GET: List Candidates
PATCH: Edit Candidate
GET: Get custom fields
GET: Retrieve Office
GET: List Offices
GET: List Users
4) Once this has been created, you can either:
a) Log into Clinch, and go to Settings > ATS Integrations > Click Edit on "Greenhouse". Paste the API Key into the box that says "Harvest API Key"
b) Email it to us and we'll connect it to your Clinch account. N.B. Option a) is a more secure option.
Once these steps have been complete, changes in your candidate status in Greenhouse will be reflected in Clinch Talent.
3. Writing a candidate's interaction score to Greenhouse, from Clinch.
In Clinch, the candidate interaction score feature gives your recruiters insight into a candidate’s interaction with your company. This next step allows your recruiters to access that information from within Greenhouse, also, making it easier than ever to determine which applicants are most engaged with your employer brand.
a) Visit https://app.greenhouse.io/custom_fields/candidates
b) Click "Add Field"
c) Fill out the fields as follows:
- Field: Interaction Score
- Description: Clinch Interaction Score
- Type: Number
When set up, Clinch will push interaction scores on a regular basis to Greenhouse.
Note: our interaction scores have recently been upgraded to take into account blog views, job views & video views. They will also degrade over time if the candidate has no recent interaction.