BackgroundChecks.com integration – Greenhouse Support

BackgroundChecks.com's integration with Greenhouse Recruiting allows users to order and review background checks directly from Greenhouse, without leaving the job or candidate record.

Configure the BackgroundChecks.com integration

Requirements: a BackgroundChecks.com account, and a Greenhouse account with admin permissions and developer permissions to manage webhooks.

Log into your BackgroundChecks.com account.
Navigate to Integrations & API → Partner Integrations.
Toggle the Greenhouse switch on.

The Greenhouse card on the Partner Integrations page before connecting, with the toggle switch highlighted.

Greenhouse's OAuth authorization screen, listing the permissions BackgroundChecks.com is requesting and an email field to sign in.

Sign in with a Greenhouse admin account and approve the requested permissions. Once approved, the popup shows a confirmation and asks you to choose which BackgroundChecks.com team new Greenhouse orders should be assigned to.

The "Candidate Hired" webhook and the report-package custom fields on your jobs and offers are configured automatically as part of this step — there's nothing to set up on the Greenhouse side.

The OAuth success popup, showing a confirmation message and a dropdown and Submit button to select the order team.

Select a team and click Submit. The popup closes and the integration is fully connected.

The Greenhouse card after connecting, showing the toggle on and the assigned order team.

You can change the order team at any time from this same card by selecting a different team and clicking Change Order Team.

Fields written to Greenhouse

Connecting the integration creates two custom fields in your Greenhouse account, populated with your active BackgroundChecks.com report packages:

Greenhouse field	Applies to	Populated with
Default BackgroundChecks.com Report Package	Jobs	Your active BackgroundChecks.com report packages, plus a "No Default Package" option
BackgroundChecks.com Report Package (optional)	Offers	Your active BackgroundChecks.com report packages

Disconnecting the integration

To disconnect, toggle the Greenhouse switch off from the Partner Integrations page and confirm.

A confirmation dialog reading: Disable Greenhouse Integration, Are you sure you would like to disable this integration?, with the confirm button highlighted.

Disconnecting removes the BackgroundChecks.com custom fields from new jobs and webhooks from Greenhouse. You can reconnect at any time by toggling the switch back on and repeating the steps above.

Use the BackgroundChecks.com integration

How to order and view background checks

Background checks are attached to a job by default.
When you advance a candidate to the Offer stage and create an offer, you'll see the option to order a background check.
You have the option to change the package for a candidate at this stage in the dropdown.
You can add background check packages to both an existing job or new job:

For existing jobs

Go to All Jobs → select the job.
Click Job Setup → Job Info.

A Greenhouse job page with the Job Setup link highlighted in the sidebar.

The Job Setup sidebar with Job Info highlighted.

In the Details section, find the setting for "Default BackgroundChecks.com Report Package" → select the Edit icon → choose the package you want to use for this job.

The Details section of Job Info with the Default BackgroundChecks.com Packages dropdown open, showing report package options.

For new jobs

Select the default package during job creation under "Default BackgroundChecks.com Report Package".

The Job Info step of new job creation with the Default BackgroundChecks.com Report Package field highlighted.

All background check package options in the dropdown are set in BackgroundChecks.com, not in Greenhouse Recruiting.

Additional resources

For anything not covered here, contact BackgroundChecks.com support at support@backgroundchecks.com or 1-800-942-1366.

In this article