Setting up the Greenhouse integration
Brainner is a platform that automates resume screening by using AI to analyze and sort candidates based on recruiter criteria. It seamlessly integrates with Greenhouse, automatically syncing job listings and candidate resumes. This guide will provide you with all the information you need to connect both solutions effectively.
In this guide you will know how to fully configure your Greenhouse integration and start using Brainner.
*Note: You must be a team or organization with admin rights in Brainner and in Greenhouse to install this integration.
To set up the Brainner integration, follow these steps:
- Step 1: Create a Harvest API Key in Greenhouse
- Step 2: Enter the API Key into Brainner
- Step 3: Create the Webhooks in Greenhouse
Detailed instructions are provided below.
Step 1: Create a Harvest API key
To configure the Brainner integration, you’ll need to create a Harvest API key.
Follow the these steps to create the key:
1. Log in to your Greenhouse account
2. Click the Configure icon on your navigation bar, then click Dev Center on the left menu.
3. Click API Key Credential Management
4. Click Create New API Key.
5. In the 'Create New Credential' box, make the following selections and click Manage Permissions:
- API Type: Harvest
- Partner: Brainner
- Description: Brainner Integration
6. Click Copy to get your API Key and store it. Then click I have stored the API Key.
*Note: you can't access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration, and then revoke access to the original key.
7. Next, you will see the permissions requested for the integration. Keep them as shown to ensure the process runs smoothly. Then, click "Save" at the bottom of the screen. Then click Save at the bottom of the screen.
Step 2: Enter the API key into Brainner
After generating the API key in Greenhouse, log in to Brainner and follow these steps to enter it:
1. Log in to your Brainner account and click on your Profile Icon on the bottom left side.
2. Click Settings .
3. Click on the ATS tab.
4. Select Greenhouse from the list of integrations.
5. Paste the Greenhouse API Key.
6. Click Connect
7. Toggle the option 'Sync Candidates from Greenhouse’
8. Click on Apply Changes
9. After applying the changes, a pop-up will appear with the final steps, including the Endpoint URL and Secret Key needed to create the Webhooks in Greenhouse. Copy this information as it will be requested in Greenhouse.
Step 3: Create the webhooks
To integrate Brainner with Greenhouse Recruiting, you’ll need to create three webhooks. Follow these steps to create your webhooks.
1. Log in to your Greenhouse account
2. Click the Configure icon on your navigation bar, then click Dev Center on the left menu.
3. Click Webhooks > Webhooks.
4. Enter the setup information and click 'Create Webhook'. You will have to repeat the process three times to create these three different webhooks:
Webhook #1
- Name: A descriptive name for your integration. Most customers choose ‘Brainner integration 1’
- When: "Candidate has submitted application”
- Endpoint URL: The Endpoint URL provided by Brainner
- Secret Key: The Secret Key provided by Brainner
Webhook #2
- Name: A descriptive name for your integration. Most customers choose ‘Brainner integration 2’
- When: “Candidate or Prospect rejected"
- Endpoint URL: The Endpoint URL provided by Brainner
- Secret Key: The Secret Key provided by Brainner
Webhook #3
- Name: A descriptive name for your integration. Most customers choose ‘Brainner integration 3’
- When: “Candidate has changed stage"
- Endpoint URL: The Endpoint URL provided by Brainner
- Secret Key: The Secret Key provided by Brainner
Congratulations! The integration between Brainner and Greenhouse is ready! If everything is set up correctly you will see the option "Sync Candidates from Greenhouse" enabled in Brainner.