How do I enable and use the Certn Integration?

Certn provides instant background checks for employers. This integration sends candidates to Certn and adds tags and pdf reports to Lever.

Table of Contents

1. Enabling the integration between Certn and Lever
2. Using the Certn integration with Lever
3. Overriding the default package

Enabling the integration between Certn and Lever

Generate API Key in Lever

1. Navigate to the Integrations and API section in Lever Settings

2. Locate "Certn" in the Background and reference checks section, click on the integration toggle to expand the card, and click the Generate new key button. 

3. Copy the API key and keep it somewhere safe. This is the one and only time that this specific API key will be accessible. If you lose the key, you can disable the integration toggle, and repeat steps 1 and 2 to generate a new one.

Generate a Webhook signing token in Lever

1. Staying on the Integrations and API section, click the "Webhooks" tab at top of the page. In the Webhook configuration list, scroll to the "Candidate Stage Change" toggle, click the + Add webhook button beneath it and copy the signature token in the card that appears.

Configure the integration in Certn

1. In Certn, navigate to Settings, click Team Settings and select the team that you want to set the integration up for.
2. Navigate to the Integrations section and expand the "Lever Integration" tab.
3. In the provided form enter the API Key and Webhook Signature token that you copied from Lever, and input the name of the Candidate stage (in Lever) that you want to serve as a trigger.
4. Create at least one Package to use with your Lever Integration by clicking the Create New Package button. Enter a name and choose at least one service to add to your package.
5. Once you have created a package, you must set it as the default by clicking the ellipses in theAction column and selecting theMake Defaultoption.
6. Click the Enable Integration button and copy the API webhook URL that is generated.

Complete the configuration in Lever

1. Navigate back to the "Webhooks" tab in the Integrations and API section of your Lever Settings.
2. Paste the API Webhook URL that you copied from Certn into the URL field beneath the "Candidate Stage Change" toggle in the Webhook configuration list.
3. Flip the "Candidate Stage Change" toggle into the on position.

Using the Certn integration with Lever

Once the integration with Certn has been set up, all that is required to start a check with Certn is to advance a candidate to the trigger stage specified at set up. Once that is done, Certn will add the tag “CERTN - Pending” to the candidate. As results are returned a link to the .pdf report will be added to the candidate and the tag will be updated to reflect the status of the check.

All candidates will be viewable on Certn. The default package can be updated or changed to another package by visiting the Lever integration section in a team’s settings on Certn.

Overriding the default package

The default package can be overridden by including the name of another package from the Lever integration package list on Certn as a tag on a candidate. For example, when setting up a default package on Certn, you are able to create additional packages. The names of these other packages can be used as tags on a candidate to trigger one of them instead of the default package.