In this guide we'll go over how to setup Greenhouse < > Hume integration.
After setting it up integration will automatically sync Jobs and Candidates in your Greenhouse organization to your Hume organization. You'll also have ability to sync Hume interview summaries into Greenhouse.
Hume needs need Greenhouse API Key to programmatically access your Greenhouse organization data. To acquire it, in your Greenhouse account, go to 'Dev Center' -> 'API Credential Management':
Then click on 'Create New API Key':
In dialog that opens select Harvest
for API Type, leave Partner
unselected:
New dialog will be opened with API Key generated by Greenhouse:
Securely store it for the time being and click on I have stored the API Key
. You will be taken to permissions view for that API Key - select Select All
checkbox to give it all permissions for Greenhouse Harvest API. When you select it it should look like this:
Click Save
.
Now that we've successfully created Greenhouse Harvest API Key let's go to Hume organization settings. One important note is that for feature of pushing interview summaries to candidates in Greenhouse app you'll have to log in to Hume with same email that has admin privileges in Greenhouse account.
There are 2 inputs:
API Key - paste API Key we've created in above steps here
Webhook Secret - write any value here, we'll use this value to configure Greenhouse webhooks later
Click Update
, if you entered wrong API Key you will be warned. In case everything was ok you'll see notification and 3 new buttons:
Test
- you can click on it to confirm your Greenhouse API Key worksSync
- to immediately sync Greenhouse Jobs and Candidates to your Hume organization, useful if webhooks failDelete
- to delete your Greenhouse integration
We're almost then - only thing left to do is to setup webhooks from Greenhouse to Hume so that Hume always hash the freshest Greenhouse data. To do so you'll need to copy 2 things:
Webhook Secret
- pressShow
first to make it visibleWebhook Endpoint
Go back to your Greenhouse account Dev Center
-> Web Hooks
:
You should see the following view:
We'll create multiple webhooks, all of them will have same Endpoint URL
and Secret key
values:
Endpoint URL
- this isWebhook Endpoint
value copied from Hume app in Greenhouse integration settingsSecret key
- this isWebhook Secret
you entered in Hume app while creating Greenhouse integration
Now you can create following webhooks with:
Job Created
Job Updated
Candidate or Prospect updated
Candidate has changed stage
After each webhook creation you should see success notification from Greenhouse.
You're good to go.