To configure Headhuntr.io - Greenhouse Integration, you will need to create a Harvest API Key. Follow the steps in this guide to create the key and verify that the given permissions and credentials are selected when configuring the Headhuntr.io integration.
The guide has the following Steps:
STEP 1: Check permissions for your account in Greenhouse
To enable the Greenhouse- Headhuntr.io integration, the user setting up the configuration is required to have the following developer’s permission:
STEP 2: Retrieve Greenhouse User ID
Headhuntr.io would also require a Greenhouse recruiting ID for all the users of the company who would be using the integration. It is required to associate the user with the data sent via integration by using the On-Behalf-Of header. The user with site admin level permissions can download the Greenhouse user IDs for the users by navigating to the Configure icon >Users >Export to Excel. Once the export to excel is clicked, a spreadsheet will be downloaded.
A. Click Configure icon > Users> Export to Excel
B. Downloaded excel with Greenhouse ID of users in the User ID column
STEP 3: Create a Harvest API Key in Greenhouse
The next step is to generate a Harvest API key with the required permissions for the integration. The following steps need to be followed:
B. Select API Credentials
C. Select Create New API Key
D. Select the following options in the Create New Credential window:
E. Select Manage Permissions
Click Manage Permissions to generate the Harvest API key. If you selected a partner in the Partner dropdown list, the appropriate permissions are assigned to the API key automatically. If the partner was not available in the dropdown, you can add permissions to the key in a subsequent step.
F. Choose Permissions
Headhuntr.io would require the following permissions to read the data and write/push candidates using Harvest API to the Greenhouse account. No Delete permissions are required by Headhuntr.io
G. Copy the generated API Key
In the subsequent dialog box, click Copy to save your API key. Store the API key in a secure location as it will be required when configuring the integration in Headhuntr.io. Click I have stored the API Key once you have copied and saved the key.
On the subsequent page, confirm the correct permissions are assigned to the Harvest API key for Headhuntr, or assign the permissions yourself by clicking the appropriate checkboxes. Once, the permissions are confirmed, click Save at the bottom of the page. Once all the steps are complete, your Harvest API Key for the Greenhouse integration in Headhuntr.io is created.
STEP 4: Configure Webhooks
To configure webhooks for the integration, follow the steps listed below:
A. Click Configure icon > Dev Center > Web Hooks
B. Click Web Hooks from the subsequent page
On the Create a New Web Hook page, provide the following information to create your first webhook.
In the user mapping page of the configuration wizard, use the downloaded excel file and navigate to the User ID column. Copy the User ID for each user from excel and paste it into the ATS Id column of the user mapping.
Review the user mapping and activate the configuration to allow the users to start using the Integration.