Skip to main content
↑

Configuring Greenhouse - HackerRank Integration

  • Updated
Hide
In this article

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 obtain the Test report for further evaluation.

This article provides you with detailed configuration steps on HackerRank and Greenhouse.

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.

Configuring Greenhouse Integration with HackerRank

The Greenhouse integration with HackerRank can be done in two ways:

Configuring Greenhouse Integration as an Admin

When configuring the Greenhouse integration with HackerRank for the first time, the administrator generates an API key that the admin must record and share with new users in the future.

Generating an API Key from HackerRank

  1. Log in to HackerRank for Work with the Company Admin user account.  
  2. On the home page, click the drop-down next to the user icon on the top right corner of the page.
  3. Click Settings.1.1.jpg
HackerRank for Work account settings
  1. Go to Integration and click Configure on the Greenhouse option.
  2. On the integration setup page, click Generate API Tokengh_integration.pngA unique API Key is displayed. key.png
  3. Copy this key. You need to add this key to the Greenhouse account to establish the integration.

Note: Ensure to store the API key safely. Once the popup is closed, you cannot retrieve the key again.

When a new user is added to the Greenhouse account, the user needs this key to set up the integration. Also, when the admin changes the API Key or generates a new key from HackerRank, all the 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 on Greenhouse. Each new user added to Greenhouse would need to enter the API key again. Please store this API key securely so it can be shared with new users at a later point.

Adding the API Key in Greenhouse

  1. Log in to Greenhouse, and click Integrations from the three-dot menu. Greenhouse_Integrations_settings.jpg
Accessing the Integration settings page in Greenhouse
  1. Search and click the HackerRank integration option.  hackerrank_option_search.jpg
Searching for the HackerRank integration
  1. Click on the Connect option, and add the API key copied obtained from the previous section.
  2. Click Save. 1.6.png
Adding the API key obtained from HackerRank for Work

 

 

Configuring Greenhouse Integration as New Users

As a user, when you log in to the Greenhouse account, you will need the API key generated by the admin, to use the integration. Also, when the admin changes the API Key or generates a new key from HackerRank, you will need to update the API key. Therefore, admins need to share the key with all users for them to update on Greenhouse. If you are a new user, please reach out to your Company-Admin to obtain the API key.

 

Adding the API Key in Greenhouse

The procedure for adding the API key to the Greenhouse account as a user is similar to that of an Administrator. For the detailed procedure, see Adding the API Key in Greenhouse.

 

 

 

 

 

Setting Up the Greenhouse Integration with HackerRank Using the API Key

  1. Log in to HackerRank for Work.  
  2. On the home page, click the drop-down next to the user icon on the top right corner of the page.
  3. Click Settings.1.1.jpg
HackerRank for Work account settings
  1. Go to Integration and click Configure on the Greenhouse option.greenhouse.pngOn the Integration setup page, the API token is displayed.gh_newusr.png
  2. You need to add this key to the Greenhouse account to establish the integration.
  3. Ensure to store the API key safely. 

 

Related articles