While your Greenhouse Recruiting account is focused on optimizing the hiring process, Beamery’s Talent CRM gives companies everything you need to engage with talent before they apply. With Beamery, every talent interaction can be highly personalized to create a unique candidate experience for each person your company speaks to.
Greenhouse Recruiting's integration with Beamery offers the best-in-class integrated CRM and ATS solution for the highest functioning sourcing and recruiting teams. The integration allows you to effectively identify past applicants with profiles that could match new roles and re-engage them with marketing content and job updates.
Create a Harvest API key for the Beamery integration
To configure the Greenhouse Recruiting / Beamery integration, you'll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the key.
Credentials
In the Create New Credential box, make the following selections:
- API type: Harvest
- Partner: Beamery (optional)
- Description: Beamery Harvest API Key
Permissions
Verify that the following permissions are selected for the Beamery integration:
Applications
- Select all
Candidates
- Select all
Tags
- Select all
Scorecards
- Select all
Offers
- Select all
Scheduled Interviews
- Select all
Activity Feed
- Select all
Departments
- Select all
Email Templates
- Select all
Jobs
- Select all
Job Posts
- Select all
Job Stages
- Select all
Offices
- Select all
Rejection reasons
- Select all
Sources
- Select all
Users
- Select all
EEOC
- Select all
User roles
- Select all
Tracking links
- Select all
Education
- Select all
Job openings
- Select all
Custom fields
- Select all
Custom field options
- Select all
Close reasons
- Select all
Approvals
- Select all
Prospect pool
- Select all
Demographic data
- Select all
Custom locations
- Select all
If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished.
Your Harvest API key for the Greenhouse Recruiting / Beamery integration is created and configured. You'll enter it into Beamery's platform using the step below.
Create an Ingestion API key for the Beamery integration
To integrate with Beamery, you'll need to create an Ingestion API key and provide it to Beamery.
Follow the steps in this article for more information on creating an Ingestion API key. Once the key is created, provide it to Beamery using the step below they can set up the integration with Greenhouse Recruiting.
Enter Greenhouse Recruiting keys on Beamery
Harvest API key
Once your Greenhouse Harvest API key is copied, navigate to your Beamery account. Open the settings menu by clicking the Gear icon in the bottom left of the navigation panel.
From the Settings menu, scroll to Data Management and click Greenhouse. This will direct you to the Greenhouse integration page.
On the Greenhouse integration page, paste the Greenhouse Harvest API key that you generated into the Import to Beamery - Harvest Key field.
When finished, click Save Credentials.
Ingestion API key
Once your Greenhouse Harvest API key is copied, navigate to your Beamery account. Open the settings menu by clicking the Gear icon in the bottom left of the navigation panel.
From the Settings menu, scroll to Data Management and click Greenhouse. This will direct you to the Greenhouse integration page.
On the Greenhouse integration page, paste the Greenhouse candidate ingestion API key that you generated and copied into the Export to Greenhouse - Ingestion API Key field.
When finished, click Save Credentials.
Create web hooks for the Beamery integration
Once your Greenhouse Recruiting keys are saved in Beamery, Beamery will generate a secret key and an endpoint URL for you to add to your Greenhouse Recruiting account. You will need to copy both to complete the integration setup.
Follow the steps in this article to create your web hooks. You will need to create 14 web hooks to complete the integration. Use the values listed below to configure the web hooks:
- Name: A descriptive name for the integration webhook. Most customers choose to differentiate the Beamery web hooks through naming them by 'when' they trigger.
-
When: The time that the event will be sent to Beamery. Create 14 different web hooks for the following different times:
- Prospect created
- Candidate has submitted application
- Candidate or prospect updated
- Delete candidate
- Merge candidate
- Candidate anonymized
- Application updated
- Candidate has been hired
- Candidate has been unhired
- Canddate has changed stage
- Candidate or prospect rejected
- Candidate or prospect unrejected
- Offer deleted
- Delete application
- Endpoint URL: Enter the endpoint URL provided by Beamery.
- Secret key: Enter the secret key provided by Beamery.
Use the Beamery integration
Terminology and data flows
It's important to review terminological differences between the Greenhouse Recruiting and Beamery to better understand how data flows between the two platforms. Check out the table below to review how prospects, candidates, and jobs are referred to in each system:
| Beamery | Greenhouse Recruiting | Description |
| Contact (prospect) | Prospect | A person not assigned to any vacancy / job. |
| Contact (candidate) | Candidate | A person assigned to at least 1 vacancy / job. |
| Vacancy | Job | A role in the company. |
| Vacancy stages | Interview stage | Stages in a hiring process. |
Once the integration is enabled, changes in any of your candidate data in Greenhouse Recruiting will be reflected in Beamery, and any data changed in Beamery will be updated in Greenhouse Recruiting.
Note: After enabling the integration, the initial syncing process takes about 24 hours.
Create an automated rule to add candidates to Greenhouse Recruiting
Now that your integration is set up, you have the option to create automated conditions to move qualified candidates you've engaged in Beamery to your account in Greenhouse Recruiting for screening. This way, you can have all your contacts in Beamery, but only sync contacts that you want to move to a screening stage.
To create a recipe, navigate to Beamery and click on your initials in the top right-hand corner of the page. Select Settings from the dropdown menu and select Recipes from the settings menu.
Set up a recipe to automatically push candidates from Beamery into Greenhouse Recruiting when they meet certain criteria.