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

The Codility integration requires set up by the Lever team. If you're interested in using Lever's Codility integration, please reach out to the Lever via the Lever Support request form. As an official Codility partner, Lever allows you to quickly and easily initiate Codility assessments and gauge a candidate’s coding and problem-solving abilities - without ever leaving Lever! All you’ll need to get started is a Lever and Codility account.

In this article

  • Setting up the Codility integration
  • Using the Codility integration

Setting up the Codility integration

  • A Super Admin on the Lever Hire account should navigate to their integration settings page and locate the Codility integration.
  • Select the toggle to expand the window, and then click the Send Request to Enable button.

Codility section in lever webhooks page with blue send request to enablel button outlined

  • A Lever support representative will automatically be notified of your request and will reach out to request the following information:
    • Trigger Stage:  The stage that automatically triggers sending a Codility test.
    • Pass Percentage Threshold: If a candidate exceeds the Pass Threshold (e.g. 90%), they will be tagged with “codility - pass”.
    • Fail Percentage Threshold: If the candidate scores below the Fail Threshold (e.g. 40%), they will be tagged with “codility - fail”.
    • Codility Access Token: You will need to send this securely.
    • Default Test (Optional): The name of the default Codility test. If configured, Lever will initiate this code test for all candidates who move into the Trigger Stage.
    • Stage on Pass (Optional): The name of the stage the candidate will automatically advance to after meeting or exceeding the Pass Percentage Threshold.


All candidates whose score falls between the pass and fail threshold will be tagged with “codility - needs review”. For example, if your pass threshhold is 90%, and your fail threshold is 40%, candidates who score 40-89% will receive the "codility - needs review" tag.

Using the Codility integration

Initiating a Codility test from Lever

Once you have completed setup, any candidate who reaches your Trigger Stage will be sent to Codility. Lever only sends the candidate name and email address to Codility. You will then be able to see the status on the homepage of the Codility dashboard.

Codility test page with list of candidates

Once the candidate has been sent to Codility, they will receive an invitation from Codility via email to begin the Codility test. Once they have completed the Codility assessment, the tag in Lever will change to "codility - result". Once Codility sends Lever a result, a Codility-gated link will be added to the links section.


This integration will prevent the submission duplicate requests (e.g. triggering a previously ordered Codility test within a Opportunity will be rejected).

If the candidate meets or exceeds the Pass Threshold, the candidate will be tagged with “codility - pass” and will advance to the Stage on Pass (if configured). If the candidate scores below the Fail Threshold, the candidate will be tagged with “codility - fail” and remain in the trigger stage. If the candidate scores somewhere in between the Pass Threshold and the Fail Threshold, a “codility - needs review” tag will be applied to the candidate.

Lever candidate profile with arrows pointing to test, codility link, and codility pass status tag

Overriding your default test

During setup, you have the option to provide a default test to send to all candidates that reach the trigger stage. However, you can also run different tests for different roles and candidates! In order to override the default test (or select a test if you did not provide a default test), simply add a tag with the name of the test to the candidate's profile before advancing them to the trigger stage.


You can automatically tag candidates based on which Postings they have applied to! Simply go to the Jobs section in Lever, click on a job, and add the Codility test name as a tag. To learn more, refer to our help article on adding and using tags.

Setting an email template

You may specify a Codility email template to be used during the invitation process by adding a tag to the candidate profile using the following format: “Codility Email Template - ” <Codility template name>.  The following information will be set via the email template: 

  • Email Subject
  • Email Body
  • Reply to address

Please refer to the Codility support page for the creation of email templates. 

Managing errors

During the creation of a Codility assessment order, if any of the following errors are encountered, an error message will appear on the candidate's profile as a note.  These errors must be resolved in Codility before attempting to create another order.  

  • Insufficient Codility Invites
  • Insufficient Privileges
  • Assessment/Test is frozen

The following error can be corrected in Lever

  • Default Codility Test Not Found can be corrected by Overriding your Default Test or contact support to setup a default Codility Test
  • Missing information can be corrected by ensuring the candidate has a first and last name along with an email address  

Once the error has been corrected, you may attempt to re-trigger the assessment order by moving to the trigger stage within Lever. 

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