Greenhouse - HackerRank Integration Guide

Last updated: February 16, 2026

HackerRank integrates with Greenhouse to streamline the candidate screening process for recruiters.
This guide explains how to integrate Greenhouse with HackerRank for Work, allowing you to send tests, schedule interviews, and view results seamlessly.

Prerequisites

Before you begin, ensure you meet the following requirements:

You have admin access to your HackerRank and Greenhouse accounts.
Your organization has an active Pro or Enterprise plan with HackerRank.
Your HackerRank login email address matches the email address associated with your Greenhouse account.

Integrating Greenhouse with HackerRank

To integrate Greenhouse with HackerRank:

Step 1: Generate an integration API token in HackerRank

The integration API token allows Greenhouse to connect securely with your HackerRank account.

Log in to your HackerRank account using your credentials.
Go to Settings > Integrations > Greenhouse > Connect, or open the Greenhouse integration page directly.
In the Configuration tab, click Generate an API Token.

Click Copy and close to copy your token.

Note: You need this token in Step 2: Add the integration API token in Greenhouse and Step 6: Create a ticket in Greenhouse Support.

Step 2: Add the HackerRank API token in Greenhouse

This step authorizes Greenhouse to connect with your HackerRank account.

Log in to your Greenhouse account using your credentials.
Go to Integrations > HackerRank, or open the HackerRank Integration page directly.
Click Connect.
In the API Key field, paste the API token generated in Step 1.
Click Save.

Step 3: Create a Harvest API in Greenhouse

The Harvest API allows Greenhouse to securely share candidate and job information with HackerRank. It also allows automatic syncing of test results and interview information.

Go to Configure > Dev Center > API Credential Management, or open the API Credential Management page directly.
Click Create new API credentials.
In the Create new credential dialog box, set the following options:
- Select Harvest as the API Type.
- Select HackerRank as the Partner.
- Enter a description.
Click Create.
Click Copy to copy the API key to your clipboard.
Note: You need this token in Step 5: Add the Harvest API key in HackerRank.
Click I have stored the API key to confirm that you have saved it securely.
In the Manage permissions section, select the required permissions listed below for the HackerRank Integration.
- Applications
  - Get: Retrieve Application: Retrieves a specific application when need. For example, to validate application details or support features that use application data.
  - Get: List Applications: Lists or filters applications by job or status to support configuration.
- Candidates
  - Get: Retrieve Candidate: Retrieve a candidate’s current data, including custom fields, before you add or update information. This prevents overwriting existing data.
  - Get: List Candidates: Verify the API key when you connect Greenhouse. The system sends a minimal request (for example, one result) to confirm the key works. It does not retrieve candidate data for normal operations.
  - Patch: Edit Candidate: Updates candidate profiles with HackerRank data such as test results, integrity signals, interview feedback. The system stores this data in custom fields or activity.
  - Post: Add Candidate: Create a new candidate in Greenhouse when you create a candidate in HackerRank. This ensures the candidate appears in Greenhouse and can receive notes, attachments, and tags.
  - Post: Add Note: Add notes to the candidate’s activity feed in Greenhouse. For example, test name, score, report link, PDF link, and score update messages.
  - Post: Add Attachment: Attach the candidate’s resume to their Greenhouse profile when you create the candidate from HackerRank.
- Custom fields
  - Get: Get Custom Fields: Retrieve existing custom field definitions and current values on candidates or jobs. This allows the integration to append new data, such as integrity signals or feedback, without overwriting existing values.
  - Patch: Update Custom Field:
    Update HackerRank data to your custom fields. For example, store test results, integrity signals, and interview feedback.
  - Post: Create Custom Field:
    Create a new custom field in Greenhouse if a required field for HackerRank data does not exist. This ensures the integration stores results and feedback correctly.
- Departments
  - Get: Retrieve Department:
    Retrieves department information associated with jobs or applications.
- Jobs
  - Get: List Jobs: Retrieve job information when you configure or use the integration. For example, validate or filter by job.
- Tags
  - Get: List Candidate Tags: Retrieve existing tag names in Greenhouse. This ensures the integration adds only missing HackerRank tags, such as test status tags.
  - Get: List Tags Applied to Candidate: Retrieve the tags currently applied to a candidate. This helps keep status in sync and prevents duplicate tags.
  - Post: Add New Candidate Tag: Create new tag names in Greenhouse, such as HackerRank test status tags, if they do not already exist.
  - Put: Add Candidate Tag: Apply the appropriate tag to a candidate after the candidate is created or updated from HackerRank.
  - Delete: Remove Tag from Candidate/Reove Candidate Tags: Remove or update tags on a candidate when the status or workflow changes. This ensures tags remain accurate.
- Users
  - Get: Retrieve User: Verify that the On-Behalf-Of user ID is valid when you connect your Greenhouse account. This ensures the integration attributes actions to the correct user.
  - Get: List Users: Retrieve user information during setup or support to validate or identify the user acting on behalf of the integration.
Click Save.

Step 4: Get the admin user ID in Greenhouse

The Admin User ID identifies the Greenhouse user who owns the integration.

Go to Configure > Users, or open the Users page directly.
Click Export to Excel.
Open the downloaded file and locate your user ID in the User ID column.

Step 5: Add the Harvest API key and admin user ID in HackerRank

This step completes the data link between HackerRank and Greenhouse.

In the HackerRank account, go to Settings > Integrations > Greenhouse > Connect, or open the Greenhouse integration page directly.
In the Configuration tab:
1. Paste the Harvest API key from Step 3 into the Greenhouse Harvest API Token field.
2. Enter the user ID from Step 4 into the Greenhouse User ID field.
Click Test and Save.

When the configuration is saved successfully, the system displays the message ATS Settings updated.

Step 6: Create a ticket in Greenhouse Support

The Greenhouse Support team manually verifies and activates your integration.

Go to the Greenhouse Support page.
Click the chatbot icon.
Select Ticket.
Click I'm a customer (I use Greenhouse at work).
Enter your Full Name and Email, and select Product question for Request Type.
Click Send.
Create a ticket:
1. Select Partner Integrations under Request topic.
2. Enter GreenHouse HackerRank Integration API as Subject line.
3. Enter Request to securely send the HackerRank Greenhouse API key for the Greenhouse – HackerRank integration. as Summary of your request.
4. Click Send.
Click Submit to send the ticket.

Once you submit the ticket, Greenhouse Support contacts you with the next steps to complete the integration. You receive a link to securely submit the API token created in Step 1.

Note: If you did not save the API token from Step 1, you can retrieve it from your Greenhouse account. You do not need to generate a new token or change any existing integration settings.

To retrieve the API token:

Go to Integrations > HackerRank, or open the HackerRank Integration page directly in your Greenhouse account.
Click Edit.
Copy the API token in the API Key field.

After you receive confirmation that the token is saved, the Greenhouse-HackerRank integration is complete. This process is usually completed within 24 hours.

Step 7 (Optional): Add a user to the Greenhouse - HackerRank Integration

After you complete the Greenhouse-HackerRank integration, you can let other users integrate Greenhouse with HackerRank using the same API key.

To add a user:

Log in to your Greenhouse account using your credentials.
Go to Integrations > HackerRank, or open the HackerRank Integration page directly.
Click Edit and copy the existing API Key.
Share the copied API key with the user you want to add.
Ask the user to follow Step 2: Add the HackerRank API token in Greenhouse to add the API key to their Greenhouse account.

Glossary

Harvest API: Greenhouse’s data-sharing interface that connects partner applications such as HackerRank.
Admin User ID: A unique identifier for your Greenhouse admin account that specifies who creates the integration connection.
API Token: A secure key that allows Greenhouse to recognize and authenticate HackerRank’s connection request.

Frequently Asked Questions (FAQs)

Why is the Greenhouse Integration page not showing in my HackerRank account?

You do not have admin access to your HackerRank account. Only admins can access the integration settings page.

Why don’t I see the ATS Settings updated message after I click Test and Save?

Verify that you entered the correct Greenhouse User ID and Harvest API Token in HackerRank.

Why am I the only user who can’t send tests through Greenhouse?

Check the following:

Your HackerRank and Greenhouse login email addresses match.
You have a Recruiter or Company Admin access in HackerRank.
You have Send Test permissions in HackerRank.
The test you are trying to send is active (not expired or deleted).