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: Add a BrightHire user in Greenhouse
Make sure you have the correct Greenhouse permissions. You will need
Can manage ALL organization’s API credentials
Manage and configure webhook
💡 We ask customers to create a Greenhouse Site Admin account for BrightHire so we can post notes correctly to candidate activity feeds.
Why this is needed
The Greenhouse API requires a user ID to post messages to the activity feed.
Using an account named “BrightHire” makes entries clear, for example, “Note created by BrightHire.”
Only Site Admins can post to all candidates’ activity feeds, which BrightHire needs to work across your organization.
Permissions and access
We do not log in to this account.
This account does not give BrightHire any additional access beyond what is required to post notes via the API.
Steps to create the BrightHire user
In Greenhouse, click the Configure icon in the upper right corner.
In the left-hand panel, click Users, then click + New Users.
In the email field, enter:
\<company-name\>@greenhouse.brighthire.aiSelect Site Admin as the permission level.
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!