Greenhouse Integration in headhuntr.io |
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 IDHeadhuntr.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:
|
A. Navigate to Configure and select Dev Center |
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
- Applications (Required)
- GET: Retrieve Application
- PATCH: Update Application
- POST: Add Application to Candidate/Prospect
- Candidates (Required)
- GET: List Candidates
- GET: Retrieve Candidate
- PATCH: Edit Candidate
- POST: Add Attachment
- POST: Add Candidate
- POST: Add Note
- POST: Add Education
- POST: Add Employment
- POST: Add Prospect
- Users (Required)
- GET: Retrieve User
- GET: List Users
- Job Posts (Required)
- GET: List Job Posts
- GET: Retrieve Job Post
- GET: List Job Posts for Job
- GET: Retrieve Job Post for Job
- Jobs (Required)
- GET: List Jobs
- GET: Retrieve Job
- Job Stages (Optional)
- List Job Stages
- GET: List Job Stages for Job
- GET: Retrieve Job Stage
- Prospect Pool (Optional)
- GET: List Prospect Pools
- GET: Retrieve Prospect Pool
- Departments(Optional)
- GET: List Departments
- GET: Retrieve Department
- GET: Retrieve Application
- PATCH: Update Application
- POST: Add Application to Candidate/Prospect
- GET: List Candidates
- GET: Retrieve Candidate
- PATCH: Edit Candidate
- POST: Add Attachment
- POST: Add Candidate
- POST: Add Note
- POST: Add Education
- POST: Add Employment
- POST: Add Prospect
- GET: Retrieve User
- GET: List Users
- GET: List Job Posts
- GET: Retrieve Job Post
- GET: List Job Posts for Job
- GET: Retrieve Job Post for Job
- GET: List Jobs
- GET: Retrieve Job
- List Job Stages
- GET: List Job Stages for Job
- GET: Retrieve Job Stage
- GET: List Prospect Pools
- GET: Retrieve Prospect Pool
- GET: List Departments
- GET: Retrieve Department
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.
H. Save
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 pageOn the Create a New Web Hook page, provide the following information to create your first webhook.
Webhook 1
|
