HackerRank, the developer skills company, helps businesses attract, evaluate and hire the best technical talent from around the world. Over 2,000 customers across all industries, including 25% of the Fortune 100, rely on HackerRank to raise their hiring bar. More than 7 million developers trust HackerRank to learn and practice coding skills. Greenhouse Recruiting's integration with HackerRank allows you to seamlessly add HackerRank's assessment to a job's interview plan. In this article, we will cover how to:

Note: HackerRank Developer accounts cannot be used with the Greenhouse/HackerRank integration. Users will need a HackerRank recruiter license to send out tests.

Enabling the Integration

To enable the integration with HackerRank, each user will need to input a HackerRank global API Key into their respective Greenhouse accounts. The HackerRank global API Key is generated from a HackerRank account administrator's account which will then be shared with other recruiters in your organization.

Note: Every Greenhouse user will need to input the global API key using the steps below.

To retrieve this API key, navigate to HackerRank and click on your Name in the upper right-hand corner. Click Settings from the drop-down menu.

From the Settings page, click API Access from the left-hand panel and navigate to Greenhouse Integration and click Generate API Key.


An API key will generate in the provided field. Click the Copy icon to the right of the API key to save the key to your clipboard.


With your HackerRank API key copied, log in to your Greenhouse account and navigate to the Integrations tab on your navigation bar.


From the Integrations page, use the provided search bar and find HackerRank. Select HackerRank from the search list.


Click Connect on the HackerRank integration page, and input your HackerRank API Key in the provided field. When finished, click Save.

The integration between Greenhouse and HackerRank is now enabled.


Add HackerRank Stage to Job's Interview Plan

Once the Greenhouse/HackerRank integration is enabled for your organization, you will be able to add the HackerRank assessment as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.


From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.


From the Add Stage dialog box, select the HackerRank stage. When finished, click Add to apply the stage to the job's interview plan.


Configure the HackerRank Stage

Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose assessments that you have previously set up in HackerRank.

Select the appropriate assessment and assign at least one Greenhouse user to grade/review submitted assessments. When finished, click Save.

Note: Keep in the mind that all configuration of the assessment itself, as well as the email template, will need to be done in HackerRank. 

Send and Review the Test

When candidates are moved into the HackerRank interview stage, Greenhouse will display a Send Test link.

Note: When you send a test from Greenhouse, the interview instructions are actually sent by HackerRank.

The status of the test will be viewable in Greenhouse:

  • Take Home Test to be sent.
  • Waiting for candidate to submit test
  • Scorecard due from <DESIGNATED_GRADER>

Once the candidate has submitted their test, you can view their HackerRank score by opening the Interview Kit for the HackerRank Interview.