Summary
This integration is designed to incorporate the background check process seamlessly into your workflow in Greenhouse.
Our Greenhouse integration allows you to order a background check directly from the Greenhouse.
This article will explain and show you how to:
Create an API Key with permissions configured in Greenhouse
Enable the Greenhouse integration within BackgroundChecks.com
Setup Webhook in Greenhouse
Order a background check from Greenhouse
View the status of the candidate's background check
Click to view and review a background check from Greenhouse
Requirements to Get Started
You must have a BackgroundChecks.com account and Greenhouse account with admin permissions to create an Greenhouse API Key.
If you are not a BackgroundChecks.com customer, click the button below to create an account, or you may also contact our sales team [email protected] to discuss custom packages or volume pricing.
Connect Greenhouse to BackgroundChecks.com
Step 1: Create an API Key in your Greenhouse Account
Log into your Greenhouse account, and navigate to partner marketplace
Under partners, choose BackgroundChecks.com
Create an API Key with the following permission settings:
Users
Get: List Users
Candidates
Post: Add Note
Custom Fields
Post: Create custom field
Delete: Delete custom field
✂️ Copy this API key to paste into your BackgroundChecks.com account
Step 2: Enter API Key in BackgroundChecks.com Account
Log into your BackgroundChecks.com account, and navigate to Integrations & API, click the 3rd Party Integrations tab, or click here for BackgroundChecks.com integration settings.
Click the Greenhouse Integration toggle switch
📝 Paste the Greenhouse API Key you copied from your BackgroundChecks.com account.
Select the Greenhouse Admin to be the owner of the BackgroundChecks.com integration & choose which BackgroundChecks.com team you want orders associated with.
Note: Greenhouse requires a user to be associated with this API Key and Integration. If this admin user is ever removed from Greenhouse, you'll need to re-connect with different admin.
Copy the following webhook & secret key from BackgroundChecks.com. You will need to add this to Greenhouse.
Step 3: Enter Webhook & Secret Key into Greenhouse
Navigate back to Greenhouse.
On the settings page, choose webhooks, and create a webhook and enter the secret key.
Step 4: Integration Complete! 🎉
Once the steps are complete, you will see the toggle switch enabled
There will be a dropdown that allows you to re-assign all background check orders to another team.
How to Order, and View Status & Background Checks
Background Checks by default are attached to a job. When you advance the Candidate to the offer stage, you will see the option for background check.
If you would like to change the BackgroundChecks.com package for a specific Canidate at this stage you can by simply selecting another package in a dropdown.
You can add background checks to an existing job or new job.
Adding BackgroundChecks.com Package to an Existing Job
If you have an existing job you would like to add BackgroundChecks.com background check package to then you need to edit the Job Info
Go to All Jobs and select the Job
Click Job Setup on left hand menu
Click Job Info on left hand menu to see job settings
Near the bottom of the Details section you will see a setting for “Default BackgroundChecks.com Report Package”
Click the Edit pencil icon
Select which BackgroundChecks.com background package configured for your account you want to use for this Job.
Adding BackgroundChecks.com Package to an New Job
To add a BackgroundChecks.com background check to a new job template. Simply select the default background check package under “Default BackgroundChecks.com Report Package”