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.

Configuring Greenhouse Integration with HackerRank

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

Configuring Greenhouse Integration as an Admin

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.

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 in the top right corner.
  3. Click Settings.settings.png
  4. On the left pane, click Integrations. The Integrations page is displayed. Scroll down and click Configure on the Greenhouse option. You can also search the Integration from the Search bar.gh_connect.png
  5. Click Generate API Token to generate the API token. integ_greenhouse.pngA unique API Key is displayed. 
  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.

For a New User

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_gh2.png
  5. Click Save. The integration with HackerRank and Greenhouse is now set up.

Add your Harvest API Token

Prerequisite

You will need to set certain permissions in your Greenhouse account before generating the Harvest API Key.

  • Navigate to Settings > Dev Center > API Credential Management and set the following permissions:greenhouse_permissions.png
You can follow the steps in the video below or keep reading to learn how to add your Harvest API Token.

 

Generate a Harvest API Token in the Greenhouse

You will need to generate a Harvest API token.

To generate the Harvest API token, see the section Create a new Harvest API key in this Greenhouse support article. 

Add the Harvest API Token to HackerRank

  1. After you have generated your Harvest API key, navigate back to the Greenhouse Integration Settings page in HackerRank.
  2. You can then paste the API key into the Greenhouse Harvest API Token.

After adding your token, proceed to the step Add your Greenhouse User ID. 

Add your Greenhouse User ID

In this step, you will add your Greenhouse User ID to the Integration Settings page in HackerRank.

You can follow along with the steps in the video below or keep reading to learn how to add your Greenhouse User ID to HackerRank.

 

Find your Greenhouse User ID

  1. You can start by navigating to Greenhouse.
  2. You can follow the steps in this Greenhouse support article to capture your User ID.

Note: Users can export the list instead to find their User ID. Refer to the steps listed in Greenhouse Recruiting.

Add your Greenhouse User ID to HackerRank

  1. Once you have your Greenhouse User ID, navigate to the Greenhouse Integration Settings page in HackerRank.
  2. You can then copy and paste your Greenhouse User ID into Greenhouse User ID.

  3. After ensuring you have added your Harvest API Token and your Greenhouse User ID, you can click Test and Save.

    You will see a message, ATS Settings Updated. This message indicates that your integration settings have been updated correctly.

    If you have any questions or don’t receive the confirmation message, contact support.

Copy and Send the HackerRank Greenhouse API Token to Greenhouse Support

After you have performed the above steps to set up your Greenhouse Integration, you will need to copy and send the HackerRank Greenhouse API Token to the Greenhouse support.

  1. Obtain a copy of the HackerRank Greenhouse API Token:
    • Get a copy of the token from the HackerRank company admin that generated the token from the HackerRank Greenhouse Integrations page.

Alternatively, you can generate a new API token. If a new API token is generated, save a copy and distribute the API token to your recruiting team so they can also save the token on the Greenhouse integrations page (Greenhouse > Integrations > HackerRank) as noted in Greenhouse - HackerRank Integration Configuration Guide

  1. Save the copy of the HackerRank Greenhouse API token within the Greenhouse
    integration page:
    • Navigate to the Greenhouse Integrations page and save the HackerRank Greenhouse API key.
    • Go to Greenhouse > Integrations > HackerRank and copy-paste in the API key within the API key.
  1. Submit a ticket to Greenhouse Support and securely send the HackerRank Greenhouse API key to Greenhouse:
    • In the browser, enter the Greenhouse URL.
    • Click to chat with the bot on the right side of the screen.
    • Click Email. 
    • Enter your email address and Subject as HackerRank integration update.
    • Select the Product as Greenhouse Recruiting, GHR Request Type as Jobs and Job Board.
    • Enter the Description as Request to securely send the HackerRank Greenhouse API key for the Greenhouse - HackerRank Integration.
    • Click Submit.

Greenhouse Support will reply with further instructions and a link to send the API key securely.

Related articles