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.

1. Log in to your HackerRank account using your credentials.

2. Go to Settings > Integrations > Greenhouse > Connect, or open the Greenhouse integration page directly.

3. In the Configuration tab, click Generate an API Token.

   

4. Click Copy and close to copy your token.

Step 2: Add the HackerRank API token in Greenhouse

This step authorizes Greenhouse to connect with your HackerRank account.

1. Log in to your Greenhouse account using your credentials.

2. Go to Integrations > HackerRank, or open the HackerRank Integration page directly.

   

3. Click Connect.

4. In the API Key field, paste the API token generated in Step 1.

   

5. 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.

1. Go to Configure > Dev Center > API Credential Management, or open the API Credential Management page directly.

   

2. Click Create new API credentials.

3. 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.

4. Click Create.

5. 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.

6. Click I have stored the API key to confirm that you have saved it securely.

7. In the Manage permissions section, select the required permissions for HackerRank Integration.

   

8. Click Save

Step 4: Get the admin user ID in Greenhouse

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

1. Go to Configure > Users, or open the Users page directly.

2. Click Export to Excel.

   

3. 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.

1. In the HackerRank account, go to Settings > Integrations > Greenhouse > Connect, or open the Greenhouse integration page directly.

2. 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.

3. 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.

1. Go to the Greenhouse Support page.

2. Click the chatbot icon.

   

3. Select Ticket. 

   

4. Click I'm a customer (I use Greenhouse at work). 

   

5. Enter your Full Name and Email, and select Product question for Request Type.

   

6. Click Send. 

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

8. 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.

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

Adding 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:

1. Log in to your Greenhouse account using your credentials.

2. Go to Integrations > HackerRank, or open the HackerRank Integration page directly.

3. Click Edit and copy the existing API Key.

   

4. Share the copied API key with the user you want to add.

5. 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)