Enabling and using the Simpliverified, LLC 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 configure) Manage pipeline stages
• (To use) Manage profiles and view associated postings
Packages LeverTRM, LeverTRM for Enterprise

The Simpliverified, LLC integration allows automation of a background check during the application process. This background check can happen at any specified stage during the application/hiring process in Lever. For more information refer to the Simpliverified website

Setting up the Simpliverified, LLC integration


You must be a team or organization with admin rights in Simpliverified to install this integration.
  • Contact Simpliverified, LLC to initiate the integration enablement process

Configuring the Simpliverified, LLC integration

Configure webhook

  • The Simpliverified, LLC team will provide the Webhook URL
  • In Lever, generate the Webhook Signature Token by navigating to Settings > Integrations and API > Webhooks
  • Scroll down to the 'Candidate Stage Change' webhook
  • Click + Add webhook
  • Enter the Webhook URL provided by Simpliverified, LLC into the webhook URL field in Lever
  • Copy the signature token to a secure place

Webhook configuration tile in Lever settings

Configure stage

  • In Lever, navigate to Settings > Pipeline and archive reasons
  • Scroll to locate your background check stage; this will be the stage that will be used to initiate the background check
  • Click Reveal stage ID

Reference check stage in Lever pipeline stage settings with Reveal Stage ID outlined

  • Copy the Stage ID
  • Securely provide Simpliverified, LLC with the Webhook Signature Token and Stage ID to complete setup

Configure tags

  • You can override defaults set in Simpliverified, LLC by using tags on the Lever opportunity
  • To do this, Simpliverified, LLC will need to know the desired tag prefixes. These prefixes will be the beginning of the Lever tag that Simpliverified, LLC looks for when receiving an order or creates when sending results.
  • Prefix overrides will be used on Package/Product, Reference Field, sub-client ordering, Flagging, and the Report Decision. This will be discussed with Simpliverified, LLC when configuring the integration.

Using the Simpliverified, LLC integration

Initiating the background check with Simpliverified, LLC

To initiate a background check with Simpliverified, LLC, move the candidate to the designated trigger stage in Lever (e.g. "Background Check"). The integration will send Simpliverified, LLC the following candidate details:

  • name (required)
  • email (required)
  • phone
  • tags (only tags with set prefixes will be used)
  • position department
  • position title
  • location

Once received, two things will occur:

  1. The new “Background Check Status:” tag will be created on the Lever candidate opportunity.
  2. A Simpliverified, LLC “QuickApp” will be sent to the candidate’s email and phone (depending on pre-configured client settings with Simpliverified, LLC).

Background check status

The integration will update the “Background Check Status:” tag on the Lever candidate opportunity. Please find below a list of statuses: 

  • Pending: Simpliverified, LLC has received the request and the “QuickApp” was generated correctly
  • Rejected: Simpliverified, LLC did not receive or accept the request and there was a problem; a note with the error description will be added to the opportunity in Lever
    • For example, if an email is missing on the opportunity the request will be rejected.
  • In Progress: the candidate has completed the “QuickApp” and the background check is being performed
  • Complete: background check has been completed and results are in Lever
  • Error: an issue between Lever and Simpliverified, LLC communication

Background Check Status error tag outlined on candidate profile in Lever; outlined note on candidate profile reads applicant's email address is required for Quickapp

Background check results

When the Simpliverified, LLC background check is completed, the status tag will update and a note with the background check results will be created on the candidate opportunity in Lever. The note will be sent as “secret” meaning that only authorized users will have access to see the results.

In addition, depending on the customer configuration, two new tags will be created:

  • "Flag": To indicate if the report was “flagged”
  • "Decision": Indicates the “Report Decision”.

Completed, Flag, and Decisions tags outlined on candidate profile; background check link outlined on candidate profile story

Other integration functions

Product ordering

  • A default product will be set during the initial configuration (outlined in the "Configuring the Simpliverified, LLC integration" section above). This value can be changed by contacting Simpliverified, LLC support.
  • The default product can be overridden by adding a Lever tag with a specific prefix.
  • The prefix is also set during the initial configuration and can be customized.
    • For example, the prefix could be set to “Product:” or “Package – “.
  • The value that follows the prefix will need to be the exact name of the Product/Package created in Simpliverified, LLC.
    • For example, if there is a default product “Criminal Package 1” and an override prefix of “Product:” and a tag of “Product: Criminal Package 2” is included and added on the Lever candidate opportunity, then “Criminal Package 2” will be the product used for the background check instead of the default “Criminal Package 1”.
    • If the tag does not have the exact prefix added to the beginning, then the default package will be ordered.
    • If the prefix is correct, but the product specified does not match a product in Simpliverified, LLC exactly, then it will either use the default or error. This is another setting that can be configured.

Sub-Client ordering

  • To take advantage of Sub-client ordering, Lever’s Location field is used to map to a field of choice within Simpliverified, LLC.
  • The following options are supported:
    • “Client Code”
    • “Client Name”
    • “Client City”
    • “Don’t support sub-clients”
  • If the location matches the option selected, then the sub-client will be used in Simpliverified, LLC.
  • If the value of the Location does not match the selected Simpliverified, LLC value then it will either revert to the main client or return an error. This is another setting that can be configured.

Reference field value

The reference field is not something that is always used by Simpliverified, LLC customers. With that in mind, there are a couple of Lever values that can be mapped to it:

  • “Don’t support Reference Field”
  • “Job Title”
  • “Job Department”
  • “Through Tags”

If “Job Title” or “Job Department” are selected, then it will automatically map to those Lever values.

If “Through Tags” is selected, then another setting to set the prefix will be used to identify the correct tag from Lever.

Flagging and report decision

  • Users will have the option to send Flags and Report Decisions with the results.
  • If electing to use Flags and Report Decision, then users will be required to set a prefix that Simpliverified, LLC will use to create new tags in Lever when it sends results.
  • Flags will be sent as a true or false value.
  • If the Prefix is “Flag:”, then the tag created will be “Flag: True” or “Flag: False”. The Report Decision tag will send whatever value is selected on the Simpliverified, LLC report.

Disabling the Simpliverified, LLC integration

  1. In Lever navigate to Settings > Integrations and API
  2. Under the Authorized Apps tab, locate the Simpliverified, LLC app
  3. Click Revoke access to disable the integration
Was this article helpful?
0 out of 0 found this helpful