The BrightHire/Greenhouse integration allows users to seamlessly schedule and launch interviews, sync interview notes, and fill out Scorecards. In order to use this integration, you will need to complete a few simple steps.
Step 1: Open Greenhouse Integration Page in BrightHire
Open the Greenhouse Integration Page in BrightHire by visiting this link.
Step 2: Configure User Permissions in Greenhouse
Set Up User Permissions:
Make sure you have the correct Greenhouse user permissions; you’ll need to have the flag ‘Can manage ALL organization’s API credentials' and 'Manage and Configure Webhooks'. If you do not have it, a Greenhouse admin in your org can provision it for you. More details here.
Add a BrightHire User in Greenhouse:
In Greenhouse, click on the Configure icon in the upper right-hand corner.
Navigate to Users on the left-hand panel, and click + New Users.
Type <company-name>@greenhouse.brighthire.ai into the email input and click Site Admin.
Uncheck Send invitation email.
Click Save.
Your settings should look like this:
Locate and click on the <company-name>@greenhouse.brighthire.ai user in the Users list.
Locate the Host (Domain) and Admin User ID in the URL
Navigate to the BrightHire/Greenhouse Integration Page you opened at the beginning
Enter the Host (Domain) and Admin User ID into the input box (as shown below).
Step 3: Create a Harvest API Key for the Greenhouse/BrightHire Integration
Click on the Configure icon in the upper right-hand corner of Greenhouse.
Navigate to Dev Center on the left-hand panel.
Click API Credential Management.
Click Create New API Key
Give your API key a name and select Harvest from the Type dropdown menu.
Click Manage Permissions.
On the Manage API Key Permissions page, click "Select All". When finished, click Save.
Your Harvest API key for the Greenhouse/BrightHire integration is created and configured. Navigate back to the BrightHire open tab, and Enter this API key into the API Key input box, click Save.
Step 4: Complete your Greenhouse Integration
Check Enabled.
Click Save
The Integration Status at the top should display a green checkmark. If not, there should be an error message. You can follow the instructions or contact support.
Step 5: Complete your Settings
Navigate to your BrightHire settings page and generate a webhook signature key
Hit the generate key button
Navigate to Greenhouse > Settings > Dev Center > Webhooks > Webhooks
Enter a name for your new webhook - 'brighthire-interview'
When - Interview Deleted
Copy webhook URL from BH and paste into endpoint URL field
Copy the generated key and paste it into Secret key
Disabled set to No
Create Webhook
Data Retention Webhook - Required if using the Data Retention feature
Navigate to Greenhouse > Settings > Dev Center > Webhooks > Webhooks
Enter a name for your new webhook - ‘brighthire-candidate-anonymized’
When - Candidate Anonymized
Copy webhook URL from BrightHire and paste into endpoint URL field
Copy the generated key and paste it into Secret key
Disabled set to No
Create Webhook
Note: To automate this - check the box: “If the candidate’s data is anonymized in Greenhouse.” on this page in BrightHire (Configure > Compliance > Data Retention).
Congratulations! Your BrightHire/Greenhouse Integration is complete!