--- title: "Ashby: Overview & Setup" description: Learn how to integrate Ashby with HackerEarth Assessments. Generate your API token and connect both platforms in a few simple steps. --- [Skip to content](https://help.hackerearth.com/ashby-overview-setup#main-content) English Show submenu for translations ![HE logo.png\]](https://help.hackerearth.com/hs-fs/hubfs/HE%20logo.png?height=40&name=HE%20logo.png) Open main navigation Close main navigation - English Show submenu for translations Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Help Center](https://help.hackerearth.com/?hsLang=en) 2. [Assessments: ATS integrations](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en) 3. [Ashby](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#ashby) # 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. **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**. ![Screenshot 2026-04-23 at 15.35.40 (1)](https://help.hackerearth.com/hs-fs/hubfs/Screenshot%202026-04-23%20at%2015.35.40%20(1).png?width=669&height=347&name=Screenshot%202026-04-23%20at%2015.35.40%20(1).png) 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**. ![image (6)-3](https://help.hackerearth.com/hs-fs/hubfs/image%20(6)-3.png?width=670&height=636&name=image%20(6)-3.png) 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**. ![Screenshot 2026-04-23 at 15.43.15 (1)](https://help.hackerearth.com/hs-fs/hubfs/Screenshot%202026-04-23%20at%2015.43.15%20(1).png?width=670&height=264&name=Screenshot%202026-04-23%20at%2015.43.15%20(1).png) 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**. ![Screenshot 2026-04-23 at 15.52.38 (1)](https://help.hackerearth.com/hs-fs/hubfs/Screenshot%202026-04-23%20at%2015.52.38%20(1).png?width=670&height=310&name=Screenshot%202026-04-23%20at%2015.52.38%20(1).png) 7. The Ashby integration will now appear as connected on the ATS Integrations page. #### **Step 3: 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 4: 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. ![image (7)](https://help.hackerearth.com/hs-fs/hubfs/image%20(7).png?width=670&height=309&name=image%20(7).png) 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: | **Field** | **Value to enter** | | --- | --- | | HackerEarth API Key in Ashby marketplace | Assessment secret generated from HackerEarth under the Ashby integration | | Ashby API Key in Ashby marketplace | API key generated from Ashby Admin \> Integrations \> API Keys | | Ashby API Key in HackerEarth integration setup | API key generated from Ashby Admin \> Integrations \> API Keys | 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: - 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. - [Assessments: Recruiters](https://help.hackerearth.com/assessments-recruiters?hsLang=en#main-content) - [Getting started](https://help.hackerearth.com/assessments-recruiters?hsLang=en#getting-started) - [Account settings](https://help.hackerearth.com/assessments-recruiters?hsLang=en#account-settings) - [Admin management](https://help.hackerearth.com/assessments-recruiters?hsLang=en#admin-management) - [Creating tests automatically](https://help.hackerearth.com/assessments-recruiters?hsLang=en#creating-tests-automatically) - [Creating tests manually](https://help.hackerearth.com/assessments-recruiters?hsLang=en#creating-tests-manually) - [Test settings](https://help.hackerearth.com/assessments-recruiters?hsLang=en#test-settings) - [Sections and question pooling](https://help.hackerearth.com/assessments-recruiters?hsLang=en#sections-and-question-pooling) - [Libraries](https://help.hackerearth.com/assessments-recruiters?hsLang=en#libraries) - [Multiple Choice Questions (MCQs)](https://help.hackerearth.com/assessments-recruiters?hsLang=en#multiple-choice-questions-mcqs) - [Programming](https://help.hackerearth.com/assessments-recruiters?hsLang=en#programming) - [Project](https://help.hackerearth.com/assessments-recruiters?hsLang=en#project) - [SQL](https://help.hackerearth.com/assessments-recruiters?hsLang=en#sql) - [Data science](https://help.hackerearth.com/assessments-recruiters?hsLang=en#data-science) - [Machine Learning (ML)](https://help.hackerearth.com/assessments-recruiters?hsLang=en#machine-learning-ml) - [DevOps](https://help.hackerearth.com/assessments-recruiters?hsLang=en#devops) - [Python project questions](https://help.hackerearth.com/assessments-recruiters?hsLang=en#python-project-questions) - [Automation Testing](https://help.hackerearth.com/assessments-recruiters?hsLang=en#automation-testing) - [Java Project](https://help.hackerearth.com/assessments-recruiters?hsLang=en#java-project) - [C# project questions](https://help.hackerearth.com/assessments-recruiters?hsLang=en#c-project-questions) - [Subjective](https://help.hackerearth.com/assessments-recruiters?hsLang=en#subjective) - [Approximate](https://help.hackerearth.com/assessments-recruiters?hsLang=en#approximate) - [Diagram](https://help.hackerearth.com/assessments-recruiters?hsLang=en#diagram) - [File upload](https://help.hackerearth.com/assessments-recruiters?hsLang=en#file-upload) - [Invites](https://help.hackerearth.com/assessments-recruiters?hsLang=en#invites) - [Reports](https://help.hackerearth.com/assessments-recruiters?hsLang=en#reports) - [Billing](https://help.hackerearth.com/assessments-recruiters?hsLang=en#billing) - [HackerEarth Reports: Admins, Tests, and Teams](https://help.hackerearth.com/assessments-recruiters?hsLang=en#hackerearth-reports-admins-tests-and-teams) - [Technical Content Updates](https://help.hackerearth.com/assessments-recruiters?hsLang=en#technical-content-updates) - [FaceCode](https://help.hackerearth.com/facecode?hsLang=en#main-content) - [FaceCode and its features](https://help.hackerearth.com/facecode?hsLang=en#facecode-and-its-features) - [Scheduling interviews on FaceCode](https://help.hackerearth.com/facecode?hsLang=en#scheduling-interviews-on-facecode) - [Assessments: ATS integrations](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#main-content) - [Integration](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#integration) - [iCIMS](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#icims) - [Zoho Recruit](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#zoho-recruit) - [SmartRecruiters](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#smartrecruiters) - [EightFold](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#eightfold) - [SuccessFactors](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#successfactors) - [Greenhouse](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#greenhouse) - [Lever](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#lever) - [Linkedin Talent Hub](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#linkedin-talent-hub) - [JazzHR](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#jazzhr) - [Workable](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#workable) - [Recruiterbox - Trakstar Hire](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#recruiterbox-trakstar-hire) - [Jobvite](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#jobvite) - [Ashby](https://help.hackerearth.com/assessments-ats-integrations?hsLang=en#ashby) - [Assessments: Product updates](https://help.hackerearth.com/assessments-product-updates?hsLang=en#main-content) - [Release notes: HackerEarth Assessment](https://help.hackerearth.com/assessments-product-updates?hsLang=en#release-notes-hackerearth-assessment) - [Root Cause Analysis (RCA)](https://help.hackerearth.com/assessments-product-updates?hsLang=en#root-cause-analysis-rca) - [Content updates](https://help.hackerearth.com/assessments-product-updates?hsLang=en#content-updates) - [Assessments: Best practices](https://help.hackerearth.com/assessments-best-practices?hsLang=en#main-content) - [Recruit](https://help.hackerearth.com/assessments-best-practices?hsLang=en#recruit) - [SSO](https://help.hackerearth.com/sso?hsLang=en#main-content) - [SSO](https://help.hackerearth.com/sso?hsLang=en#sso) - [Upskilling](https://help.hackerearth.com/upskilling?hsLang=en#main-content) - [Introduction: Upskilling](https://help.hackerearth.com/upskilling?hsLang=en#introduction-upskilling) - [Assessments: Candidates](https://help.hackerearth.com/assessments-candidates?hsLang=en#main-content) - [Getting started](https://help.hackerearth.com/assessments-candidates?hsLang=en#getting-started) - [Test environment](https://help.hackerearth.com/assessments-candidates?hsLang=en#test-environment) - [Question types](https://help.hackerearth.com/assessments-candidates?hsLang=en#question-types) - [FaceCode](https://help.hackerearth.com/assessments-candidates?hsLang=en#facecode) - [Feedback and queries](https://help.hackerearth.com/assessments-candidates?hsLang=en#feedback-and-queries) - [Problem setting for HackerEarth](https://help.hackerearth.com/problem-setting-for-hackerearth?hsLang=en#main-content) - [Rate cards](https://help.hackerearth.com/problem-setting-for-hackerearth?hsLang=en#rate-cards) - [Campus](https://help.hackerearth.com/campus?hsLang=en#main-content) - [Recruiters](https://help.hackerearth.com/campus?hsLang=en#recruiters) - [Recruiter FAQs](https://help.hackerearth.com/campus?hsLang=en#recruiter-faqs) - [Candidate FAQs](https://help.hackerearth.com/campus?hsLang=en#candidate-faqs) - [Hackathons and Hiring Challenges](https://help.hackerearth.com/hackathons-and-hiring-challenges?hsLang=en#main-content) - [Hackathons](https://help.hackerearth.com/hackathons-and-hiring-challenges?hsLang=en#hackathons) - [Hiring challenges](https://help.hackerearth.com/hackathons-and-hiring-challenges?hsLang=en#hiring-challenges) - [Frequently Asked Questions (FAQs)](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#main-content) - [Assessments: Recruiters](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#assessments-recruiters) - [GDPR compliance (Candidates)](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#gdpr-compliance-candidates) - [GDPR compliance (Recruiters)](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#gdpr-compliance-recruiters) - [General](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#general) - [Assessments: Candidates](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#assessments-candidates) - [HackerEarth Vs ChatGPT](https://help.hackerearth.com/frequently-asked-questions-faqs?hsLang=en#hackerearth-vs-chatgpt) - [Profiles](https://help.hackerearth.com/profiles?hsLang=en#main-content) - [Profiles - Recruiter](https://help.hackerearth.com/profiles?hsLang=en#profiles-recruiter) - [OnScreen](https://help.hackerearth.com/onscreen?hsLang=en#main-content) - [OnScreen - Interview templates](https://help.hackerearth.com/onscreen?hsLang=en#onscreen-interview-templates) - [OnScreen - Sending Invites](https://help.hackerearth.com/onscreen?hsLang=en#onscreen-sending-invites) - [OnScreen - Download reports](https://help.hackerearth.com/onscreen?hsLang=en#onscreen-download-reports) - [OnScreen - Interview Analytics](https://help.hackerearth.com/onscreen?hsLang=en#onscreen-interview-analytics) - [OnScreen - Overview](https://help.hackerearth.com/onscreen?hsLang=en#onscreen-overview) - [OnScreen - Interview Proctoring Settings](https://help.hackerearth.com/onscreen?hsLang=en#onscreen-interview-proctoring-settings) [![Chill listening crop-3](https://help.hackerearth.com/hs-fs/hubfs/HE%20Logo%20for%20sig-1.png?width=120&height=24&name=HE%20Logo%20for%20sig-1.png "Chill listening crop-3")](https://www.hackerearth.com/) Copyright © 2026, HackerEarth