Skip to main content
↑

Greenhouse - HackerRank Integration Configuration Guide

  • Updated
Hide
In this article

Overview

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

Additionally, the users can schedule interviews from Greenhouse that can be taken on the HackerRank platform.

Important: Once you set up the integration configuration for HackeRank - Greenhouse, you can use the same integration to send Test invites and schedule interviews from Greenhouse.

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 shared with this user account.
    • Create email invite templates for customizing the Test invites sent from Greenhouse.
  • Log in using the Greenhouse account with 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 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.
  3. Click Settings.settings.png
  4. Go to Integration and click Configure on the Greenhouse option.integrations_menu.png
  5. On the integration setup page, click Generate API Tokengenerate_token.pngA unique API Key is displayed. api_token.png
  6. Copy this key. You will 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 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 must enter the API key again. Store this API key securely so it can be shared with new users later.

Adding the API Key in Greenhouse

  1. Log in to Greenhouse, and click the Integrations tab.gh_integrations.png
  2. Click the HackerRank integration option.  hr_gh.png
  3. Click Connect.connect_integration.png
  4. Add the API key obtained from the HackerRank platform.api_key_gh.png
  5. Click Save. The integration with HackerRank and Greenhouse is now set up.

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, contact 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.

 

Related articles