Enabling and using the Mercer | Mettl integration

Available for User roles Super Admin, Admin, Team Member, Limited Team Member
Can only be configured by Super Admins
Packages All packages

The Mercer | Mettl integration allows you to send assessments to candidates in the the configured stage and view the results on Lever.

Readers of this article will learn the following:

Setup the integration:


Access role must be Super Admin in Lever to set up the integration. You must have an Enterprise account with Mettl to enable the integration.

1. Contact the Mercer | Mettl Support Team and raise a request to enable the Lever integration.

2. The Mercer | Mettl team will send you an encrypted link using to authorize your Lever credentials.

Mercer | Mettl platform showing Authorize your credentials card with authorize via Lever button.

3. Select the Trigger Stage of your choice.

Mercer | Mettl platform showing Credentials Authorized message and authorized tag.


In case you would like to create a custom Trigger Stage, please reach out to Lever Support via the Lever Support Request Form. Once the custom stage has been created, you may then use this encrypted link to select the newly created stage.

4. In Lever, go to Settings > Integrations and API > Webhooks. 

5. Toggle-on the webhook group, "Candidate Stage Change" to begin sending data. 

How to use the integration:

Sending a Mercer | Mettl test to a Job Applicant

1. The assessment and its security settings will be configurable for each job using tags. Opportunities tied to the posting will inherit the tag. This includes mandatory and optional tags.

Mandatory Input Tags

  • "Mettl Test - {Assessment Id}" : The customer may log into Mettl to retrieve the assessment ID. This helps Mettl understand which assessment is to be triggered (e.g. "Mettl Test - 367696")

Optional Input Tags

  • "Mettl BT - {Count}": Browsing Tolerance – Basis the limit specified, the test taker gets warnings each time they navigate away and the test is stopped as soon as the limit is breached.
  • "Mettl VP - screen": Visual proctoring – If this tag is added, the test taker will need a webcam to attempt the assessment. The webcam and screened will be captured throughout the duration of the test and any suspicious activities will be flagged.
  • "Mettl OTP": To start the test, the test taker will need to enter an OTP that would be sent to their email ID.

2. Once the opportunity is moved to the trigger stage, an assessment is sent to the candidate with the configured settings as indicated through the optional tags described above.

3. When the test is:

  • Sent to the test taker: a new tag is added - "Mettl Test - {Assessment Id} - Sent"
  • Started by the test taker: the tag is updated to - "Mettl Test - {Assessment Id} - In Progress"
  • Completed: the tag is updated to - "Mettl Test - {Assessment Id} - Completed"

4. Additionally, a new note is created on the opportunity with the following information:

Mercer | Mettl platform note with test information.

See example below:

Lever platform Mercer | Mettl note with test information.

How to disable the integration:

1. Navigate to your Integrations & API Settings Page in Lever.

2. Under the Authorized Apps tab, locate the Mercer | Mettl app.

3. Click Revoke Access to disable the integration.

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