Lever Integration

Creighton Foulkes  •  July 25, 2018  •  ATS


We're excited to be partnering with Lever to enable our customers to more easily assess with Py. This integration allows you to automatically send Py tests via Lever. Below are instructions on how to set up the integration.

Set Up Instructions


Contact your Lever point of contact or to request a Lever API Key for the Py integration with the following permissions:

Do not delete the API Key from Lever Settings, or the integration will stop working!


1. Once Lever has sent the API Key, please contact your Py Account Manager and send the following information:

Lever API Key: the API Key provided to you by Lever.

Stage Name: the name of the Lever stage that will trigger a Py test ("Trigger Stage"). You can specify multiple Trigger Stages if you wish.

Default Py Test (Optional):For each Trigger Stage, you can optinally set a Default Py Test to be sent.

Provide your Py Account Manager with the stage name(s) in Lever that should trigger a Py test. You can optionally provide a default test for a given Trigger Stage.

Pass Threshold (Optional):If the candidates scores at or above the Pass Threshold, the candidate will automatically be marked with the tag "Py - Pass".

Fail Threshold (Optional):If the candidates scores at or below the Fail Threshold, the candidate will automatically be marked with the tag "Py - Fail".

2. Request from your Py Account Manager the Lever Webhook URL. Once you receive this URL, add it to the "Candidate Stage Change" field in Lever.

Sending a Py Test from Lever

Once you've completed setup, any candidate who reaches your Trigger Stage will be sent a Py test. You'll then be able to see the status in a tag on the Lever candidate.

Once the candidate has been sent to Py, they will receive an invitation from Py via email to begin the Py test. Once they've completed the Py assessment, the tag in Lever will change to "Py - Needs Review". Once Py sends Lever a result, a link will be added to the links section with the Py report.

Overriding your Default Test

During setup, you provide a default test to send to all candidates that reach the Trigger Stage. However, you can also send different tests for different roles and candidates! In order to override the default test, simply add a tag with the name of the test to the candidate's profile before advancing them to the Trigger Stage!