Skip to main content
↑

Adding Candidates to Greenhouse ATS from a Public Link

  • Updated
Hide
In this article

Overview

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

By mapping a test to a particular job on the ATS, 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 successfully enable public test URL to ATS integration.

Supported ATS:

You must be using one of the following supported ATS Systems.

  • Greenhouse
  • Lever 

Prerequisites

HackerRank for Work On the ATS
  1. You must own an Enterprise plan with a Recruiter license.
  2. You must have an activated Recruiter type user account with Company Admin and/or Team Admin permissions. This user account must belong to a team with access to the test.
  3. The test needs to have a public or private test URL. 

Global configuration settings on Greenhouse:

    • POST: Add New Candidate Tags
    • DELETE: Remove Tag from a candidate
    • GET: List Tags Applied to a candidate
    • GET: List Candidate Tags
    • PUT: Add a Candidate Tag
    • DELETE: Remove Candidate Tags
    • POST: Add Attachment
    • GET: Retrieve Department
    • GET: List Jobs
    • POST: Add Note

Global configuration settings on Lever:

  • Create candidate
  • List Postings

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. Obtain the API key from your ATS as follows: 
    • For Greenhouse ATS, you can get this key on greenhouse from Settings -> Dev Centre -> API Credentials Management -> Create Harvest API Key. ATSa.jpg
    • On Lever ATS, the API key can be obtained from Lever Partner Integrations on the Lever Integrations page. 
  4. On HackerRank, click the dropdown on the top-right corner of the screen.
  5. Click Settings.1.1.jpg
  6. Select the Integration option from the left-hand pane.
  7. Click the Configure option associated with the relevant ATS.greenhouse.png
  8. The ATS setup page is displayed where you can follow the instructions to perform the configuration.
  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 step, to reconfigure the ATS or choose a different ATS. 1.5.jpg

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. ATS5.jpg
  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. Change_job_-_ATS.jpg
  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 Greenhouse ATS, 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.ATS_last.jpg

 

Related articles