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. 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

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

Hit the generate key button

  • Navigate to Greenhouse > Settings > Dev Center > Webhooks > Webhooks

  1. Enter a name for your new webhook - 'brighthire-interview'

  2. When - Interview Deleted

  3. Copy webhook URL from BH and paste into endpoint URL field

  4. Copy the generated key and paste it into Secret key

  5. Disabled set to No

  6. Create Webhook

Congratulations! Your BrightHire/Greenhouse Integration is complete!

Ready to learn more about the integration? Watch this short video for a preview.

Related Help Articles:

Using BrightHire with Greenhouse for Interviewers

Did this answer your question?