Ashby: Overview & Setup

HackerEarth Assessment and FaceCode are integrated with the ATS—Ashby. This integration allows you to screen candidates efficiently and streamline your technical recruitment workflow without leaving the Ashby platform.

You can perform the following tasks on Ashby:

• Set up multiple HackerEarth assessments as part of your Ashby interview plans.
• Invite candidates to take assessments from Ashby.
• View candidate assessment status, scores, and report links directly in Ashby.
• Schedule FaceCode interviews from Ashby.
• Sync FaceCode interview links, completion details, and report URLs back to Ashby.
  
  

Integrating Ashby with HackerEarth

To integrate Ashby with HackerEarth Assessment, follow these core steps:

1. Generate the Ashby API key for your organization.
2. Enable the integration on HackerEarth.
3. Generate the HackerEarth assessment secret from HackerEarth.
4. Configure the HackerEarth app in the Ashby marketplace.
5. Select an Ashby interview plan and configure the Assessment Invite Stage and FaceCode Invite Stage.

Prerequisites

• You must have Administrator privileges on your HackerEarth account.
• You must have Admin access in your Ashby workspace to generate API keys.
• You must have access to Ashby Admin > Integrations > API Keys.
• You must have access to the HackerEarth app in the Ashby marketplace.

Step 1: Generating your Ashby API key

To generate your Ashby API key, follow these steps:

1. Log in to your Ashby account.
2. Navigate to the Admin dashboard from the main menu.
3. In the left-hand navigation pane, under the Integrations section, click API Keys.
   
   
4. Click + New to create a new API key.
5. In the Name field, enter a recognizable name for the key (for example, HackerEarth Integration). In the Integration Partner dropdown, select HackerEarth. Selecting HackerEarth as the Integration Partner automatically configures all required permissions — this is the recommended approach.

    

   Only if the Integration Partner dropdown is unavailable or does not include HackerEarth, manually enable all permissions listed on the Ashby Create API Key page. The HackerEarth integration requires every permission to be enabled. Missing even one can prevent assessment sync, candidate updates, status updates, report updates, notes, tags, and interview-related actions from working correctly.Click Create API Key.

6. On the next screen, grant the necessary API Scopes for the integration (for example, Candidates and Interviews).
7. Click Save and Continue.
   
   
   
   
   
   
   
8. Copy the generated API key from the final screen.

Note: Keep this token secure. You will not be able to view it again once you close the window.

Step 2: Enabling the integration on HackerEarth

Once you have your Ashby API key, you can activate the integration from your HackerEarth dashboard.

1. Log in to your HackerEarth Assessment account using your admin credentials.
2. Click on Settings (gear icon) in the navigation bar.
3. Under the Integrations section, click ATS Integrations.
   
   
   
   
4. Click + Connect an ATS. A modal will appear listing available integrations. Select Ashby.
5. In the configuration window that appears, enter your Ashby Admin Email ID and paste the Ashby API Key you generated in Step 1.
6. Click Submit.
   
   
   
   
7. The Ashby integration will now appear as connected on the ATS Integrations page.

Step 3: Selecting the interview plan and trigger stages

After connecting Ashby, configure the interview plan and the stages that should trigger HackerEarth actions.

1. Open the connected Ashby integration in HackerEarth.
2. Select the Ashby interview plan that should be used for the integration. 
   Only published interview plans from Ashby are available for selection.
3. Configure the Assessment Invite Stage. When a candidate reaches this configured Ashby stage, the HackerEarth assessment invite flow is triggered.
4. Configure the FaceCode Invite Stage. When a candidate reaches this configured Ashby stage and an interview is scheduled, the FaceCode interview flow is triggered.
   
   
   
5. Save the configuration.

Note: HackerEarth actions are triggered only when the candidate is in the configured stage. If the candidate is in any other Ashby stage, no HackerEarth action is performed.

Step 4: Generating the HackerEarth assessment secret

The assessment secret is generated from HackerEarth and must be configured in the HackerEarth app in Ashby.

1. In HackerEarth, open Settings.
2. Go to ATS Integrations.
3. Open the connected Ashby integration.
4. Generate the assessment secret.
5. Copy the generated secret.

Note: The assessment secret is generated once for a company. Keep it secure. The Ashby integration works only when the valid HackerEarth assessment secret is configured in Ashby.

Step 5: Configuring the HackerEarth app in the Ashby marketplace

The HackerEarth app is available in the Ashby marketplace. Configure it after generating the assessment secret from HackerEarth.

1. Log in to Ashby as an admin.
2. Navigate to Admin.
3. Open Integrations.
4. Go to Marketplace.
5. Search for HackerEarth.
6. Open the HackerEarth app.
7. In the HackerEarth API Key field, paste the assessment secret generated from HackerEarth.
8. In the Ashby API Key field, paste the Ashby API key generated from Ashby.
   
9. Save or update the configuration.

The HackerEarth app is now configured in Ashby.

In the HackerEarth app in Ashby marketplace, enter the assessment secret generated from HackerEarth in the HackerEarth API Key field, and enter the API key generated from Ashby in the Ashby API Key field.

Important key mapping

Use the correct key in each field:

Do not paste the Ashby API key into the HackerEarth API Key field in the Ashby marketplace. The HackerEarth API Key field must contain the assessment secret generated from HackerEarth.

Setup complete

You have successfully integrated Ashby with HackerEarth.

After setup:

• Published Ashby interview plans are visible in HackerEarth.
• Assessment and FaceCode trigger stages can be configured in HackerEarth.
• HackerEarth assessments can be selected and sent from Ashby.
• Candidate assessment status, score, and report URL are pushed back to Ashby.
• FaceCode interview links, completion details, and report URLs are pushed back to Ashby.