How do I enable and use the HireRight integration?

Available for User roles Super Admins, Admins, Team Members, Limited Team Members
Plans Enterprise, Professional

Please note: The HireRight integration requires set up by both the HireRight and Lever teams. If you’re interested in using Lever’s integration with HireRight, please reach out to your HireRight Account Manager in addition to reaching out to your Lever point of contact or support@lever.co.

As an official HireRight partner, Lever makes it easy for you to order any of HireRight’s 200+ global background and drug testing services and receive results in real-time. Streamline the background check process by kicking off HireRight background check packages - without ever leaving Lever! The HireRight background check form is pre-populated with candidate information from Lever Hire reducing redundant data entry and driving administrative efficiency while improving the recruiter and candidate experience.

Setup

1. Contact HireRight: Setting up the HireRight integration involves a HireRight Technical Consultant to make sure your HireRight account is configured correctly for the integration. In order to do this, you’ll need to reach out to your HireRight Account Manager and request the Lever-HireRight integration.

2. Contact Lever: After a HireRight Technical Consultant has been staffed, they will provide you with your HireRight Company Id, a User Permissions List, and a List of HireRight packages.  Once you have that information, you can reach out to your Lever point of contact or Lever’s support team to enable the integration. In your request, please provide the following:

  • HireRight Company Id: Lever will need the Id of your HireRight Parent Account. If you have child accounts, we’ll be able to trigger packages from those too!
  • HireRight User Permissions List: A list of HireRight user emails. These are users who have permission to order the HireRight background check package from Lever. These users must also be Lever Users. The background check can only be triggered by Users on this list. If a Lever User is not on the Permissions List and attempts to order a HireRight package for a candidate, the HireRight order will not be created.
  • Trigger Stage: The stage that automatically triggers the HireRight background check package. If you've provided Lever with a Default HireRight Package, Lever will automatically run that package when a User on the HireRight User Permissions List advances a candidate to the Trigger Stage. If you have not selected a Default Package, we will look for a tag that matches the name of one of your HireRight packages.
  • Default Package (Optional): The package that you want to run automatically when a candidate is advanced to the Trigger Stage by a User on the Permissions List. If a HireRight package name is specified in a tag on the candidate profile, we will run that specific package instead of the Default package.
  • Completion Stage (Optional): The stage that you want the candidate to automatically advance to when the HireRight order is complete.

Once you have sent Lever this information, the appropriate API key and webhook settings will be configured in your Lever account. Do not delete these, or the integration will stop working!

Tip: You can automatically tag candidates based on which Postings they have applied to! Simply go to the Jobs section in Lever, click on a job, and add the HireRight package name as a tag.

Creating a HireRight Order from Lever

Once you’ve completed setup, any candidate that is advanced to your Trigger stage by a user on the User Permissions List will be sent to HireRight. Lever will send candidate details including name, email address, and phone number, job location, and education and employment history from parsed resume data to HireRight. This data will be used to pre-populate a HireRight order for the candidate.

Once sent to HireRight, you'll be able to see the pending HireRight invitations in the Screening Manager section of the HireRight dashboard:

image1.png

 The candidate will then receive an e-mail invitation from HireRight to begin the background check process. Once the invitation has been sent, Lever will add the tag "HR - Sent to Applicant" to the candidate profile. The candidate then fills out the HireRight background check form. Basic candidate data, parsed resume information, and job location are pre-filled on the form. Once the candidate finishes filling out the form, the tag “HR - Pending Applicant” is added to the candidate profile. There will only be one HireRight tag on a candidate's profile at any given time.

Screen_Shot_2018-05-30_at_3.48.06_PM_copy.png

 Once the candidate submits the background check form, the HireRight status will change to “HR - In Process”. After HireRight completes the background check, the tag in Lever will change to "HR - Completed". When the report becomes available, the integration will add a HireRight link to the links section of the candidate profile. Only authenticated HireRight users will be able to access it.

Screen_Shot_2018-05-30_at_3.53.34_PM_copy.png

Overriding your Default Package

During setup, you have the option to provide a default package to send to all candidates that reach the trigger stage. However, you can also run different packages for different roles and candidates! In order to override the default package (or select a package if you did not provide a default package), simply add a tag with the name of the package to the candidate's profile before advancing them to the trigger stage! Remember that you can automatically tag candidates on Posting-by-Posting basis. 

Drop us a note if any questions come to mind. We're always happy to help with your HireRight integration!  

Have more questions? Submit a request
Powered by Zendesk