Enabling and using the Yardstik integration

Available for Roles Super Admin, Admin, Team Member, Limited Team Member
Can only be enabled by Super Admins
Permissions • (To enable) Manage API credentials and manage integrations
• (To enable) Manage pipeline stages
• (To use) Manage profiles and view associated postings
• (To use) Create and edit postings
• (To optimize) Manage automation workflows
Packages LeverTRM, LeverTRM for Enterprise
LeverTRM for Enterprise or Advanced Automation add-on for automation workflows

The Yardstik 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!

Setting up the Yardstik 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 (blue)

Authorizing the Yardstik 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 Super Admin 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.

Disabling the Yardstik integration

In Yardstik

  • Navigate to the Developer section 
  • Click on Integrations
  • Click + on the Lever integration listing
  • In the top right corner of the Lever integration card, flip the toggle to Off

In Lever

  • Navigate to Settings > Integrations and API
  • Under the Authorized Apps tab, locate the 'Yardstik' app
  • Click Revoke Access to disable the integration


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