Enabling and using the ClearChecks integration

Available for User roles Super Admin, Admin, Team Member, Limited Team Member
Can only be configured by Super Admins
Packages All packages

The ClearChecks integration allows you to order a background check on candidates automatically as you advance them to a selected stage.

This integration is designed to incorporate the background check process seamlessly into your workflow in Lever.

Readers of this article will learn the following:

Setup the integration:

Authorize Lever integration from your ClearChecks account


Access role must be Super Admin in Lever to set up the integration. You must have a ClearChecks account to install this integration. If you are not a ClearChecks customer, contact sales@clearchecks.com to discuss custom packages or volume pricing.

1. Log into your ClearChecks account, and navigate to Integrations & API. Click the 3rd Party Integrations tab, or refer to the ClearChecks integration settings.

2. Click the toggle button to enable the Lever Integration.

Clearchecks platform showing Lever card and outline around toggle.

3. You will be prompted to enter your Lever credentials or use a SSO (single sign on) provider like Google or Microsoft to authorize the ClearChecks app. Click Accept

Lever login modal. Lever authorize app modal showing list of permissions and blue accept button.

How to configure the integration:

Select candidate stage & default package

Once you have authorized the Lever integration you will be asked to select which candidate stage you would like to trigger a background check.  In this example, we have a stage called "Background Check".  


Most Lever accounts will have a stage for a "Background Check", or you may have customized your stages and want to run a background check when the candidate is advanced to a different stage in your workflow.

Clearchecks set up showing background check stage selector and Clearclire product selector.

You must specify which background check package you would like to enable and set as the default.  


For now, this is the only background check package you will be able to order automatically from Lever. Soon, ClearChecks will support Lever tags, which will allow you to add a tag corresponding to your different configured packages. The tags will be used to trigger an order from a stage change.  However, you may select a base level package and always add additional checks to the report from within the ClearChecks report.

Toggle webhook on from Lever

In order for ClearChecks to communicate with Lever, you must toggle on the Stage Change Webhook from within your Settings > Integrations and API > Webhooks page in Lever.  

Turn this setting on, and you will see a webhook already created by ClearChecks.  If you have other integrations, this may already be toggled on, so no further action is required.

Lever integrations and API settings showing candidate stage change toggle on blue.

The ClearChecks integration is now ready for use!

How to use the integration:

How to order a background check

Order a background check automatically by advancing a candidate to your selected stage.

Lever candidate profile with dropdown list of stages and background check selected.

How to view status & review background checks

You can track the status of the background check through a tag on an opportunity.  These tags can be filtered across all opportunities.

The status tags are:

  • ClearChecks • Waiting for Applicant
  • ClearChecks • In Progress
  • ClearChecks • Clear Report
  • ClearChecks • Review Report
  • ClearChecks • Canceled

Lever candidate profile with clearchecks in progress tag outlined.

In addition, a note is added to the opportunity with a link to your reports once a background check order is placed:

Lever candidate profile showing chearchecks upated in candidate history.

Once a background check is complete:

  1. You will have a note added to the opportunity with a link to the background check
  2. A tag is created and added to the opportunity:
    • ClearChecks • Clear Report
    • ClearChecks • Review Report

Lever candidate profile showing chearchecks upated in candidate history.

Lever candidate profile with clearchecks review report tag outlined.

You may filter and group candidates by these tags:

Lever left hand menu with tags search bar outlined.

How to disable the integration:

1. Navigate to your Integrations & API Settings Page in Lever.

2. Under the Authorized Apps tab, locate the ClearChecks app.

3. Click Revoke Access to disable the integration.

Was this article helpful?
0 out of 0 found this helpful