<aside> 💡 Easily customize GitHub-based technical assessments, where candidates can complete tasks like reviewing code, submitting a pull request, or improving a system’s design.

</aside>

Section Overview:

Prerequisites

<aside> 💡 You’ll need Ashby Org Admin access to generate an API key.

</aside>

Connect Hatchways with Ashby

Step 1: Head over to the Hatchways integration settings page in the Ashby integration marketplace and click on the +Create API key for Hatchways to create a new Ashby API key**.** Copy the key generated because this will need to be provided to Hatchways.

Step 2: Configure a Candidate Application Changed Stage webhook at https://app.ashbyhq.com/admin/api/webhooks. This will let Hatchways know when a candidate should be sent an assessment. The Request URL will be provided by Hatchways, but you’ll generate the Secret Token, which you’ll provide to Hatchways.

Step 3: Provide [email protected] with:

• Ashby Job IDs
• The API key generated in Ashby from Step 1
• The Secret Token generated in Step 2
• The interview plan stage the assessment should be initiated on
• Which assessment to send candidates
• If you’d like additional Notes in Ashby and/or emails to one or more recipients with updates about candidate progress as they work through the assessment.

That’s it! You’ve now integrated Hatchways with Ashby 🎉

Using the Integration

The assessment is automatically initialized in Hatchways when a candidate is moved to the interview plan stage(s) you’ve set for the integration. The candidate receives an email to start the assessments directly from Hatchways.

As the candidate works through the assessment, updates will be provided as notes on the candidate profile page. Once they’ve completed the assessment, a link to the results will be added as a note on the candidate profile page.