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's integration with HackerRank is split into two parts:

  • HackerRank Assessment: HackerRank's primary integration allows you to seamlessly add HackerRank's assessment to an interview plan.
  • HackerRank Interview: An additional integration for organizations who want to use live coding exercises with HackerRank's live pair coding features.

For more information on using HackerRank's live pair coding, see the HackerRank Interview integration.

Set up the integration

Configuring the HackerRank Assessment integration requires you to set up an Assessment integration and a Harvest API integration.

Assessment setup

To add your assessments to Greenhouse, follow the steps in this article to retrieve your API key from HackerRank, send it to Greenhouse support, and add the assessment stage to your interview plans.

You can generate your API key directly in HackerRank. This key must have the recruiter and company admin permissions to get full access to your configured assessments. 

Harvest API key

If you already set up the Harvest API as part of the HackerRank Interview integration, you can skip these steps.

HackerRank also uses the Harvest API to send information to Greenhouse. You'll need to create a Harvest API key, retrieve your user ID, and add both items to the Greenhouse Integration Settings page in HackerRank.

Create Harvest API key

To create your Harvest API key, follow the steps in this article. Use the following permissions and credentials when setting up the integration.


In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: HackerRank
  • Description: HackerRank Harvest API Key


Make sure the following permissions are selected when configuring your API key.

  • Candidates
    • Post: Add Candidates
    • Post: Add Attachment
    • Post: Add Note
  • Tags
    • Get: List tags applied to candidate
    • Get: List Candidate Tags
    • Post: Add New Candidate Tags
    • Put: Add a candidate tag
  • Users
    • Get: Retrieve User
    • Get: List Users
  • Custom Fields
    • Get: Get custom fields
    • Post: Create custom field
    • Patch: Update custom field

Find your user ID

To retrieve your user ID, follow the steps in this article.

Enter information into HackerRank

Once you have your Harvest API key and user ID, you can enter them in the Greenhouse Integration Settings page in HackerRank.


Use the integration

Configure an interview plan

Once the integration is enabled, update an interview plan and choose HackerRank Assessment from the list of stages. Once the stage has been added to the job's interview plan, click Edit Take Home Test to choose the specific assessment and grader.

Note: The assessment configuration, including any additional settings like the email template or branding, must be configured in HackerRank.

Send and review the HackerRank test

When candidates are moved into the HackerRank interview stage on a job, a Send Test link will display on their profile.

Click Send Test and the candidate will receive an invitation with login credentials to complete the HackerRank assessment.

The status of the test will be viewable in Greenhouse Recruiting:

  • Take Home Test to be sent.
  • Waiting for candidate to submit test
  • Scorecard due from [ GRADER ]

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

Live coding exercises with the HackerRank integration

You need to use the HackerRank Interview integration to complete live pair coding exercises.

Frequently asked questions

What sort of HackerRank license do I need?

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

Why are some stages labeled "Legacy HackerRank?"

In January 2024, HackerRank upgraded their integration with Greenhouse Recruiting. If you're viewing a past interview plan that uses the previous setup, those stages will be labeled as "Legacy HackerRank."

Additional resources

For more information on the HackerRank integration, contact Greenhouse Technical Support.