Lever integration
Updated over a week ago

The Lever integration allows talent acquisition teams to seamlessly incorporate the Yardstik background check process directly into their Lever recruitment workflow. Just move your candidate to the 'Background Check' stage to easily kick off a Yardstik background check and receive results without ever leaving the Lever platform!

Readers of this article will learn about:

Setting up the Yardstik integration

You must have an access role of Super Admin in Lever in order to set up the integration. You must be a team or organization with admin rights in Yardstik to install this integration.

Creating the 'Background Check' stage

  • In Lever, navigate to Settings > Pipeline and archive reasons

  • Click on the Customize Pipeline Stages button in the top right corner

  • Click + Add Stage

  • Title the stage “Background Check”

  • Click Add Stage

  • Drag and drop the 'Background Check' stage to the desired place within your Lever pipeline

For more on this topic, refer to our help article on adding pipeline stages.

Creating the webhook

  • In Lever, navigate to Settings > Integrations and API > Webhooks

  • Ensure that the 'Candidate Stage Change' webhook is toggled on (green)

Authorizing the integration

  • In Yardstik, navigate to Developer > Integrations > Lever

  • On the Lever integration card, enable the integration by clicking on the toggle in the top right corner

  • Click Authorize

  • Log in with your Lever credentials

  • Review the list of requested access permissions; click Accept

Lever Yardstik authorization modal with list of permissions

Once authorized and enabled, the integration will automatically configure the webhooks, set up the necessary custom fields, and sync your Yardstik account’s screening packages.

Using the Yardstik integration

After the integration has been properly enabled, your webhooks and background screening packages will be automatically set up and synced to Lever.

To use the Yardstik integration, create a job posting and add the desired Yardstik background check package as a tag.

When you’re ready to perform a background check on a candidate just move the candidate to the 'Background Check' stage of the pipeline. The candidate will receive an email invite from Yardstik to complete the selected background screen package.

Linking the Lever job posting to the Yardstik background check package

  • In Lever, click Jobs in the top navigation area

  • Click the + Add Job Posting button in the top right corner

  • Enter the required job information and additional job details

  • Add the Yardstik background check package as a tag

    • Click on Add Tag at the bottom of the right panel

    • Type “Yardstik” to display the available Yardstik Packages

    • Select the Yardstik package you want associated with the job

Posting editor with tags menu expanded and Yardstick packages listed.

Moving the candidate to the 'Background Check' stage

  • In Lever, click Candidates in the top navigation area

  • Select a candidate's opportunity

  • Move the candidate's opportunity to the 'Background Check' stage

Opportunity profile with stage menu expanded and Background Check stage outlined.
  • Yardstik will send the candidate an email invitation to complete the assigned background screen package (see example of candidate email invitation below)

Email invitation to candidate inviting them to intiate Yardstick background check

Yardstik background check interface

Viewing the background check results

As a Hiring Manager or Opportunity Owner you will see the applicant’s report status display as a tag in the applicant’s information. As an Admin or SuperAdmin you will see the report status tag as well as a link to the report added as a secure note.The report status tag will also show up on the list view of candidates and is available as a filter to narrow down your candidate list.

Opporutnity list in Lever with status tags on opportunities and tags filter outlined.

Common report statuses are:

  • Created

  • Pending

  • Clear

  • Consider

  • Proceed

  • Canceled

For a full list of statuses and what they mean see refer to Yardstik's Report Status list.

Once a report has been completed, an additional tag (“ys- complete”) will be automatically added to the opportunity.

Typical completed statuses are:

  • Canceled

  • Clear

  • Proceed

  • Final Adverse

Below is an example of an opportunity that has a completed background check.

Candidate profile with completed status tag outlined.

Optimizing the Yardstik integration with automation workflows within Lever

The Automation Hub is available to customers with LeverTRM for Enterprise or the Advanced Automation add-on. If you would like access to this feature, contact Lever Support or your Lever Customer Success Manager for more information.

  • In Lever, click More in the top navigation bar

  • Select Automation

  • Click the + New Workflow button

You can now configure the workflow so that, for example, when a “ys-clear” or “ys-proceed” status tag (which indicates that the candidate did not have any disqualifying results in their background check report) is added to an opportunity, the opportunity will automatically move out of the 'Background Check' stage, and into a different stage of your choosing.

Below is an example of an automation workflow for opportunities that have a background check report that contains disqualifying results, and would lead to a hiring manager rescinding the offer.

  • When This Happens...: Tag added is ys-complete

  • Continue If...: Opportunity tags is one of these ys-final_adverse

  • Do This...: Change Stage to Rescind Offer

Automation workflow editor

To learn more, refer to our help article on automation workflows.

Did this answer your question?