How to Integrate Lever with Testlify
Before you begin
Make sure you have admin access to both your Testlify workspace and your Lever account. You will also need at least one assessment created in Testlify to map to a Lever job posting.
Step 1: Connect Testlify to Lever
- Go to your Testlify dashboard and click your profile icon.
- Click Settings.

- Click the Integration tab.
- Click Lever to start the authorization flow.

- Review the requested permissions.
- Click Accept to complete authorization.


Step 2: Enable the Lever webhook
After authorization, Testlify automatically creates a Candidate Stage Change webhook in Lever. You must enable it for the integration to work.
- In Lever, go to Settings > Integrations and API > Webhooks.
- Scroll to the Candidate Stage Change webhook.
- Toggle it to the on (blue) position if it is not already enabled.




Step 3: Map assessments to Lever job postings
Testlify reads tags on Lever job postings to determine which assessment to send and at which stage. Use this syntax:
- Testlify:<stage-name>:<assessment-name>
Example: To send the Backend Developer assessment when a candidate reaches the On-site Interview stage, add this tag to the job posting:
- Testlify: On-site Interview: Backend Developer


Important:
- The first value must always be Testlify — this tells Lever the tag belongs to Testlify.
- The stage name must match a valid stage in the job's interview plan in Lever.
- The assessment name must match an assessment created in your Testlify dashboard and linked to Lever.


Step 4: Send an assessment to a candidate
- In Lever, associate the candidate's opportunity with the relevant job posting.
- Move the candidate to the trigger stage defined in the Testlify tag on that posting.




Testlify automatically sends the candidate an email with a link to complete the assessment.

Step 5: Review assessment results
Once the candidate completes the assessment, Testlify adds a note to the candidate's Lever application containing the result and a link to view the full report in PDF format.


Need help? Contact support.