Enabling and using the Backgrounds Online integration

Follow
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 use) Manage profiles and view associated postings
Packages LeverTRM, LeverTRM for Enterprise

The Backgrounds Online integration will allow for you to initiate background checks from within Lever using your Backgrounds Online checks.


Setting up the Backgrounds Online integration

  • Contact your Backgrounds Online Account Manager to request Lever integration be enabled
  • Login to your Backgrounds Online account at clients.backgroundsonline.com
  • From the Dashboard navigate to the Integrations page via the menu in the top right

Backgrounds Online dashboard with arrow pointing to integrations in dropdown menu

  • If prompted, login to your Lever account then click Accept to establish the authorize app connection between your Backgrounds Online account and your Lever account.

Authorize app modal showing list of permissions and blue accept button

  • Once authorization is approved, you will be direct back to your Backgrounds Online account where the connection is confirmed

Configuring the Backgrounds Online integration

If you wish to do so, you may select a default background check package from the dropdown menu. This selection can be overwritten with an alternate package through your Lever account.

Backgrounds online dashboard with lever pointing to custom background check package in package selector

Using the Backgrounds Online integration

Background check initiation tags

Simply add a tag to a candidate's opportunity labelled "Backgrounds Online Start" and a new background check will be initiated using the default package. Tags will be applied to the profile denoting the progression of the check. The Backgrounds Online integration does not require moving a candidate to a new stage to trigger the integration, simply adding the tag to the profile. Note that an email address for the candidate will be a required field in order for the integration to trigger correctly. 

Lever platform with arrows pointing to tags in candidate profile

Overriding the default package

If you would like to initiate a new background check package using a package other than the default you have set, add Tag: Backgrounds Online Start with an additional tag that reads "Package: DesiredPackagename". For example, if your override package is titled “Basic” your secondary tag should read “Package: Basic”. Once the request has been sent, the panel will update with Tag: Backgrounds Online Pending Submission

Lever platform with arrows pointing to tags in candidate profile

Background check status/results tags

Once background check results are complete, the candidate’s overview panel will update with one of the following tags and accompanying notes.

  • Tag: Backgrounds Online In-Process: Once you candidate has finished their background check submission and we have begun working on their screening, the panel will update with Tag: Backgrounds Online In-Process
  • Tag: Backgrounds Online Clear: If the background check is complete with no potential adverse information found, the panel will reflect Tag: Backgrounds Online Clear with a note stating “The background check request is complete and has no potential adverse information.”
  • Tag: Backgrounds Online Review: If the background check is complete with potential adverse information found, the overview panel will reflect Tag: Backgrounds Online Review with a note stating “The background check request is complete and has potential adverse information.”
  • Tag: Backgrounds Online Cancel: If you wish to cancel a background check request, you may add Tag: Backgrounds Online Cancel to do so. Note, cancellation is only available if the panel currently reflects Tag: Backgrounds Online Pending Submission. If your request has been successfully cancelled, the panel will update with Tag: Backgrounds Online Cancelled with a note stating “The background check request has been cancelled.”
  • Tag: Backgrounds Online Expired: Background check requests sent via your Lever integration are valid for 14 days. Once the request has surpassed 14 days without candidate submission, the panel will update with Tag: Backgrounds Online Expired with a note stating “The background check request has expired.”

Disabling the Backgrounds Online integration

  • Navigate to Settings > Integrations and API > Authorized Apps
  • Locate the Backgrounds Online app
  • Click Revoke Access
Was this article helpful?
0 out of 0 found this helpful