Greenhouse - HackerRank Tests Integration

Overview

HackerRank's Tests integrate with Greenhouse to facilitate a seamless and efficient Candidate screening process for recruiters. As part of their interview workflow, Greenhouse users can directly send HackerRank Test invites to Candidates and also obtain the Test report for further evaluation.

This article provides you with detailed integration steps and also describes how you can send HackerRank Test invites directly from Greenhouse.

Note: Refer to the Greenhouse - HackerRank Interview Integration topic to know how to quickly initiate interviews with Candidates in Greenhouse. See the Greenhouse Integration - Troubleshooting Tips topic to know answers for some frequently asked questions.

Prerequisites

In HackerRank for Work

In Greenhouse

You must own an Enterprise plan with a Recruiter license. You must have an activated Recruiter type user account with Company Admin permissions. This user account must belong to any team. Log in with this user account to:   Generate the Greenhouse API key Create and publish HackerRank Tests required to invite Candidates from Greenhouse. Alternatively, you can also use Tests that are shared with this user account. Create email invite templates for customizing the Test invites sent from Greenhouse.

Log in using the Greenhouse account which has the same email address as the HackerRank for Work Company Admin user account. This is important for sending HackerRank Test invites and generating interview links in Greenhouse. Example: If the email address in HackerRank for Work is jackpeters@hackerrank.com, the Greenhouse user account must also include the same email address. You must have relevant administrative permissions to the Integrations page.

Configuration Guide

Obtaining the API key from HackerRank

Important: When a new recruiter is added to the Greenhouse account, they will need the API Key to set up the integration. So it is important to Store the API Key somewhere so that you can use it whenever it is necessary. 

1. Log in to HackerRank for Work using the Company Admin user account.  
2. On the home page, click the arrow next to the user icon on the top right corner of the page, and select Settings.

HackerRank for Work account settings

4. Go to ATS Integration and click on the Configure button under the Greenhouse option.
5. On the integration setup page, click on the Generate API token button
6. The unique API Key will be displayed in the next popup. Copy this key and close the pop-up. 
7. This key needs to be added to the Greenhouse account to establish the integration.
8. Make sure to store the API key safely as once the popup is closed it will not be possible to retrieve the key again. When a new user is added to the Greenhouse account, they would be needing this key to set up the integration. Also, when the admin changes the API Key or generates a new one from HackerRank, all current users will need to update their keys. Hence, admins need to store the key and share it with all current users for them to update in Greenhouse.

 

Adding the API key in Greenhouse

1. Log in to Greenhouse, and click on the Integrations from the three-dot menu. 

Accessing the Integration settings page in Greenhouse

2. Search and click on the Hackerrank integration option. 

Searching for the HackerRank integration

3. Click on the Connect option, add the API key copied obtained from the previous section.
4. Click on the Save button. This completes the integration.

Adding the API key obtained from HackerRank for Work

User Guide

Creating Tests and Email Invite Templates in HackerRank

1. Log in to HackerRank for Work with the same account used to generate the Greenhouse API key.
2. Based on the specific job role or technical skills expected in Candidates, create and publish HackerRank Tests required to invite Candidates from Greenhouse. Alternatively, you can also use the HackerRank Tests which are shared with your user account. For more information, refer, Sharing a Test

HackerRank Tests to be used in Greenhouse

3. Create email invite templates for sending different Test invites sent from Greenhouse. Alternatively, you can use HackerRank's default email template in Greenhouse.

Creating templates for sending Test email invites from Greenhouse

For more detailed information on tests and templates, refer to the Create Tests and Email Templates in HackerRank for Work.

HackerRank Test Stage in a Greenhouse Job Interview Plan

In Greenhouse, the integration automatically creates a "Hackerrank Test" stage for jobs. When you associate this stage to a job's interview plan and move a Candidate to the "HackerRank Test" stage, a "Send Test" link is automatically available to send the HackerRank Test invitation.

To associate the "HackerRank Test" stage to a Job:

1. Open a Job and click on the Job Setup tab.
2. Click on the Interview Plan option, and then click +Add a Stage.

The Interview plan stages of a Job in Greenhouse

3.  Add the HackerRank Test stage to the job.

Adding the 'HackerRank Test' stage to a Job's interview plan

Sending HackerRank Test Invites from Greenhouse

1. In Greenhouse, open a Candidate profile, click on the Move Stage option and change the Candidate's stage to HackerRank Test.

Changing the Candidate's stage to "HackerRank Test"

2. Click on the Send Test link displayed under the HackerRank Test stage.

The option to send a HackerRank Test invite

3. In the Send Test window, 

• Select the required HackerRank Test to which you want to invite the Candidate.
• Select one of the email templates for the chosen format of the invite.
• Select the Greenhouse user who will be assigned the HackerRank Test report for evaluation.

4. Click on the Send Test button to send the invite to the Candidate.

Sending a HackerRank Test invite to the Candidate

5. After the Candidate submits the Test, the Test score is updated in the Candidate's profile under the HackerRank Test stage.

The Candidate's Test performance report updated in the Candidate's profile in Greenhouse

6. Select the HackerRank Test interview kit to view the Candidate's Test performance report and scores. Click on the View Report option to open the Candidate's detailed performance report in HackerRank for Work.

The Candidate's interview kit displaying the Candidate's Test performance details