Adding Candidates to Lever ATS from a Public Link

Overview

HackerRank enables you to assess candidates' skills as a first step in your recruiting process even before they enter your Lever ATS system. With this feature, any candidates taking an assessment from a public link are automatically created within the Lever. (Currently, this is available only for Lever and Greenhouse users). Click here for a similar article for Greenhouse.

By mapping a test to a particular job on Lever, recruiters can obtain detailed candidate test reports for that job role whenever a candidate attempts the test on HackerRank for Work. This is done using an API access token (which queries the recruiter's ATS for their job list) and embedding that API key onto HackerRank. 

This article explains the steps to enable a public test URL for Lever integration.

Supported Applicant Tracking System:

You must be using the Lever Applicant Tracking System (ATS).

Prerequisites

Integration and Configuration Steps

1. Log in to your HackerRank for Work account.
2. Under Test Access Settings of the required test, ensure that the test has a Public Test URL (accessible by anyone who has the link to the test). Refer to the Test Access Settings article to quickly create a public test URL in case your test does not have one.
3. Ensure that Lever has been integrated with HackerRank Tests: 
   
   • If your Lever Integration(s) need to be set up, refer to the Lever - HackerRank Tests Integration article.
   • 
4. Then, within Lever, you'll need to access Settings and click on the Integrations and API tab, to ensure that the HackerRank Tests integration is connected. 
   • 
5. After checking on the connection status of HackerRank Tests, scroll up to the top of the page and access the API Credentials Tab (At the top of the screen)
   • 
6. From the API Credentials tab, scroll down to the Lever API credentials section. (As seen highlighted above within the API Credentials tab)
   • You'll then need to ensure that the Key that you'll be working with for HackerRank Tests and HackerRank Interviews has the proper Read and Write endpoints assigned, including both:
     • Create Candidate
     • List Posting
       • The Read endpoints and Write endpoints are two separate sections, make sure both fields are checked in each section.
         • Scroll down past the Read endpoints section (as seen below) to access the Write endpoints section.
   • 
   • 
7. Select the Integration option from the left-hand pane.
8. Click the Configure option associated with Lever.
9. After you complete the configuration, open Test.
10. Go to Test Settings -> ATS integration and ensure you see the connected ATS.

Clicking on ATS Settings takes you back to the ATS integration setup page, shown in the previous steps, to reconfigure the ATS or choose a different ATS.

Selecting a Job for the Candidates to Take a Test

1. After the configuration, candidates taking a particular test from a public link are added to your ATS in this Job. Click Choose Job and select the appropriate job role for which candidates are taking this test.
2. Mapping a job from the ATS to the test can fail under the following circumstances:
   • The job has no owner - You can see a prompt screen where you can assign an appropriate HackerRank for Work user as the owner for the job.
   • The owner of the job does not have a HackerRank for Work account - You can see a prompt to create a user account.
     • The owner of the job does not have test access - You can see a prompt to add the recruiter to a team on HackerRank for Work, thereby granting them test access.
3. After you choose a job that is mapped to the test successfully, the candidate test reports are pushed to your ATS. You can change the job that is mapped for the particular test, or remove the mapping.
4. With a successful test to job mapping, on your ATS, you should be able to see the candidate test reports and other details every time a candidate attempts the test.

For example, on Lever, sign in and navigate to the Candidates section for the job mapped to the public test link. You can see the candidate's test report, score, and test name as shown. This information is also available in the Activity Feed.