Enabling and using the HackerRank Tests integration

Available for User roles All users. Can only be configured by Super Admins.
Packages All Lever packages

HackerRank Tests allows you to assess and capture meaningful information about a candidate's technical skills. This integration allows recruitment teams to seamlessly send out code challenges to candidates prior to a live interview. Once a candidate has completed an assessment, the results automatically populate onto their Lever profile, removing the need for recruiters to switch between applications. Readers of this article will learn about:

Before proceeding, note that Lever's integration with HackerRank Tests is only available to users with Interviewer or Recruiter licenses in HackerRank. For more information about this integration, refer to HackerRank's Lever integration help article.

Enabling the HackerRank Tests integration


The following setup steps can only be completed by a user with Super Admin access in Lever.

Step 1: Generate an API key in HackerRank

  • Log into HackerRank for Work as a Company Admin user.
  • On the home page, click the arrow next to the user icon in the top-right corner and select Settings.
  • Navigate to the ATS Integration section and click Configure on the Lever tile.

HackerRank Settings page with arrow pointing to ATS integration section in left nvigation and Configure button on Lever tile.

  • Click the Generate API Token button and copy the key that is generated. Note that this key is unique and you will not be able to retrieve it again after this stage of the process.

Copy Token modal in HackerRank settings containing API key.

Step 2: Add the API key in Lever

  • Navigate to Settings > Integrations and API, scroll to the Assessments section, and click the HackerRank Tests toggle.

HackerRank Tests toggle in Lever Settings wiht arrow pointing to Access token field on tile.

  • Paste the API key into the Access token field and click Verify Connection. The toggle will turn green to indicate the integration has been enabled.

Using the HackerRank Tests integration with Lever

Associating HackerRank Tests with Interview Plans

Before sending an assessment to a candidate, navigate to the Interview Plan tab of any individual job posting and select the “HackerRank” form for the necessary assessment stages. Note that this form is automatically added to your LeverTRM instance when the integration is enabled.

Interview Plan with HackerRank form selected in Skills Fit stage.

Sending a HackerRank Test to a candidate

To send an assessment to a candidate, move the corresponding opportunity to the stage that is associated with the HackerRank feedback form and click the Send Test button that appears at the top of the candidate profile.

Send Test call to action banner circled at the top of candidate profile.

Alternatively, you can send a test to a candidate at any time throughout the interview process by clicking the ellipses button at the top of the candidate profile and selecting Send Test.

Clicking Send Test will open the test window where you will be able to:

  1. View the candidate’s name and the job posting(s) with which they are associated.
  2. Select a specific HackerRank Test to send to the candidate.
  3. Choose which candidate email address to send the HackerRank Test to.
  4. Optionally, choose to send the candidate an additional email via Lever.
  5. Edit the additional email using the email editor in Lever and use typical email features, including auto-text tokens, templates, and rich text options.
  6. Indicate if you wish to receive notifications via email and the Lever Inbox when the HackerRank test is completed.

Send test modal in Lever with fields labelled as outlined in the list above.

Once an assessment has been sent, you can view the pending HackerRank Test within the candidate's profile. Clicking the Reminder button will open the email workflow in Lever.

After the candidate completes the assessment, Lever will create a story on their candidate profile that will include the following information:

  • Score
  • Candidate feedback
  • Plagiarism check
  • Total time taken
  • Time candidate started test
  • Link to full report
  • Name of specific HackerRank test completed

Completed assessment in candidate story.

The overall score field will be calculated automatically by Lever (visible in the upper-left of the above image). Those with Super Admins and Admin level access in Lever can edit the overall score by clicking on the Edit button to the right of the feedback form. Team Members and Limited Team Members do not have the ability to edit the score of a HackerRank Test.

How Lever calculates the assessment score

To calculate the score, Lever first the candidate's score by the maximum score possible for the assessment:

(candidate’s score) ÷ (max possible score for the assessment)

Lever will then assign a score of 1 to 4, based on the following percentage scale:

  • 0.00 - 0.24 = score of 1
  • 0.24 - 0.49 = score of 2
  • 0.50 - 0.74 = score of 3
  • 0.75 - 1.00 = score of 4


Consider an assessment on which a candidate scores 98 points against a maximum of 120 points, resulting in a 0.82 percentage as follows: 98 ÷ 120 = 0.82

Given that 0.82 falls between the range of 0.75 and 1.00, Lever would assign a score of 4 on the feedback form for this assessment.

Viewing the full HackerRank Test assessment report

Once a candidate has completed their HackerRank Test assessment, a link to the full report (which will open in HackerRank for Work) will be included in the story that is added to their candidate profile in Lever (see image above). Followers of the candidate in Lever will receive an email notification as well as a notification in their Lever inbox, if configured as such when the assessment was sent.


Users must log into HackerRank for Work before clicking the report link in Lever in order to view it. Issues with the HackerRank report link should be directed to HackerRank Support for the fastest resolution.
Was this article helpful?
0 out of 0 found this helpful