Enabling and using the cFIRST integration

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

Here’s the quickest way to enable integration between Lever and cFIRST for seamless background checks experience for your recruitment teams and candidates. 

Readers of this article will learn the following:

Setup the integration:

Note: Access role must be Super Admin in Lever to set up the integration.

Enable the Integration

1. Log into the cFIRST application and navigate to the menu. Click on the Integrations tab. Locate Lever in the list and click the icon to enable the integration. 

cFirst platform with integrations tab and Lever integration card outlined.

2. This will get you on the Lever authentication page using oAuth authentication. After providing login details, it will ask for the scope approval as provided in the screen below. Click Accept

Lever authorize app modal with list of permissions and blue accept button

3. Once successfully configured, you will be sent back to the cFIRST portal which will be displaying additional details required for the integration.

Configure Webhooks

You'll need to generate a Webhook token in Lever for candidate stage changes so that your candidates can be pushed from Lever to cFIRST upon moving into a designated "Background Verification" stage (or any other stage of your choosing).

This webhook token can then be added to cFIRST.

1. In cFIRST, copy the link available in the “Candidate Stage Change Webhook URL” field and paste it into a document so you can reference it later on in the configuration.

cFirst platform showing Lever platform with candidate stage change field and signature token outlined.

2. Go to Settings > Integrations & API > Webhooks in Lever. 

3. Scroll down to the Candidate Stage Change webhook and click + Add webhook

4. Copy the “Candidate Stage Change Webhook URL” from the cFIRST portal and paste it to the Candidate Stage Change webhook url field in Lever. Click Verify Connection

Lever platform integrations and API page with candidate stage change field and verify connection button outlined.

5. If the connection is successfully verified, copy the Signature token from the Candidate Status Change webhook settings on Lever into the "Signature Token" field on cFIRST. 

6. Select "Background Verification" from the Stage dropdown list. 

cFirst platform showing Lever platform with candidate stage change field and signature token outlined and stage options in stage selector dropdown.

7. Select the default screening package from the list. Click Submit

cFirst platform showing package selector menu.

How to use the integration:

To trigger background checks process within your Lever account, change the candidate stage to “Background Verification”.

The cFIRST app will action the necessary steps to invite candidate to share details/documents to process background checks.

Lever platform candidate profile with background verification in stage selector menu outlined.

You can also choose to select a package in Lever by adding a tag of the package name to the opportunity.

The existing packages can be found by typing "cfpkg:". You will see all available packages as drop-down options under the tag.

If you want to use an alternate package than the default one, you can use that as well.

Lever platform job posting with cFirst tag outlined.

How to disable the integration:

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

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

3. Click Revoke Access to disable the integration.

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