Integrating with Ashby

Integrating Codility with Ashby allows you to seamlessly invite, review, and store your candidate test reports all in one interface.

Getting Started

To connect the integration, you must generate an API Key in Codility and configure the integration within Ashby. Follow the steps below:

1. Log in to your Codility account. (Admin or Recruiter permissions required)
2. Navigate to Apps & Integrations in Codility. 
3. Select Custom Integrations > Create App, name the integration Ashby, and click Create.
4. Copy the value once the API Key is generated, as you will need this for Ashby.
5. Open a browser tab with Ashby on the Admin > Integrations page.

Connect Ashby to Codility

1. On the Ashby integrations page, find and select Codility, and then click the green "Enable Codility" button. 
2. Next, add the Codility API Key you created to the Codility API Key field.
3. Select the Ashby API Key drop-down to create or choose an existing key for this integration. If you are choosing an existing Ashby API key for this integration, please verify that your Ashby API key has Write access to the Candidates set of endpoints, as this includes the assessment.update endpoint, which will be used to send data back to Ashby about the assessment.

   • Note: While it says to copy this API key, you do not need to. This API key is just used to control access for the Codility integration.

At this point, you're all set to use Codility in your interview plans!

Configure your Interview Plans

Now that you’ve connected the integration, the next step is configuring the Interview Plans for your jobs in Ashby. Here, you will be able to select which Codility Assessment should be used and at which stage.

1. Navigate to Jobs > Dashboard
2. Select the job for which you wish to configure a Codility test.
3. Under Interview Plans, select “+ Activity” under the corresponding stage you’d like to use.
4. Select Codility from the sidebar menu under integrations.
5. Pick the Codility assessment from the dropdown and select add.

At this point, your job is configured, and you will see the Codility assessment under the respective stage selected.

Sending the Invitation to your Candidate

Once you're ready to send the assessment to your candidate, you will see the option to "Start Assessment". This will open a new window prompt where you can change the test if needed. 

Once you've confirmed the correct assessment has been selected, select "Start." This will trigger the test, and an email invitation will be sent to your candidate from Codility. 

Default Email in Integration

The Ashby integration will use the default invitation email selected on the Codility account. You can manage and customize this directly in your Codility account under My Account > Settings > Email Templates.

If you have questions about the integration, please reach out to support@codility.com.