1. TestGorilla Help Center
  2. Integrations and API

Ashby integration

Updated

Approx. reading time: 4 minutes

You can connect TestGorilla to your Ashby account, allowing you to invite candidates to an assessment and view their results directly inside Ashby. The Ashby integration is available on the Plus plan and can be enabled by users with Owner or Admin access.

Important: You must be an Organizational Admin in Ashby to complete the setup. You can confirm this by checking whether the Admin tab is visible at the top of your Ashby account. If it is not visible, contact your IT department or Administrator. Ashby does not display who your admin is.
Ashby navigation bar showing the Admin tab
The Admin tab must be visible in Ashby. If you can see it, you have the right access level.

 

Set up the integration

The setup switches between TestGorilla and Ashby. Follow the steps in order and pay attention to which app you should be in at each stage.

 

Step 1: Copy the Kombo API Key

In TestGorilla, click your name in the top right → Integrations → select Ashby to open the connection flow. Then follow the steps below.

Inside the connection flow, you will see a Kombo API Key. Click Copy to copy it. Then click Link to Integration to open the Integrations page in Ashby.

TestGorilla connection flow showing Kombo API Key and Link to Integration button
Copy the Kombo API Key, then click "Link to Integration" to open Ashby
 
Step 2: Paste the Kombo API Key in Ashby

In Ashby, go to Admin → Integrations → Kombo, then:

1 Click the Kombo API Key input box and paste the key you copied.
2 Click the refresh icon (labelled "Test API Key" on hover) to verify the key works.
3 Click Update.
Ashby Kombo integration page with Kombo API Key field and refresh button
Paste the Kombo API Key, click the refresh icon to test it, then click Update
 
Step 3: Create an Ashby API Key
1 Click the Ashby API Key input box.
2 Type a name for the key, for example Assessment Integration. Choose a name that clearly describes its purpose.
3 Click Create new API key "Assessment Integration" (or the name you entered) from the dropdown that appears.
Ashby API Key field with Assessment Integration typed and Create option shown
Name your Ashby API Key and click Create
 
Step 4: Copy the Ashby API Key

Once created, the API Key appears on screen. Click Copy to copy it.

Important: Save your API Key somewhere safe before continuing. You will only have this one opportunity to copy it. If you lose it, you will need to delete the key and create a new one.
Ashby showing the newly created API Key with Copy button
Click Copy. This is your only chance to copy this API Key
 
Step 5: Configure API Key Permissions
1 Click the external link icon next to the Ashby API Key field. This opens the key's detail page.
2 Click the Configure API Key Permissions button.
3

Enable the following permissions:

  • Api Keys: Read
  • Candidates: Write
4 Click Save Permission Settings.
Configure API Key Permissions modal showing Candidates Write and Api Keys Read enabled
Enable "Api Keys: Read" and "Candidates: Write", then click Save Permission Settings
 
Step 6: Paste the Ashby API Key and complete setup in TestGorilla

Return to the connection flow in TestGorilla. Paste the Ashby API Key you copied in Step 4 into the Ashby API Key field, then click Set up integration.

TestGorilla connection flow with Ashby API Key field filled and Set up integration button
Paste the Ashby API Key and click "Set up integration" to finish

 

Use the integration

After connecting the integration, you can invite candidates to assessments and view their results directly inside Ashby.

 

Invite candidates

To invite an individual candidate to a TestGorilla assessment:

1

Go to the Candidates page, select the candidate, and click New Activity.

Ashby candidate page with New Activity button
Select a candidate and click "New Activity"
2

Select Assessment from the dropdown.

Dropdown with Assessment option
Select "Assessment" from the dropdown
3

Select TestGorilla as your assessment vendor.

Assessment vendor selection showing TestGorilla
Select TestGorilla as the assessment vendor
4

Click Select assessment type... and choose the assessment you want to send.

Assessment type selection popup
Choose the assessment to send
5

Click Add Activity in the popup.

Add Activity button in popup
Click "Add Activity"
6

The assessment appears under the candidate's Current Activities. Click Start Assessment.

Current Activities section with Start Assessment button
Click "Start Assessment" from the candidate's Current Activities
7

Click Start in the confirmation popup. The candidate will receive an invitation to take the assessment.

Start confirmation popup
Click "Start" to send the assessment invitation

 

Set up bulk invites

You can configure Ashby to automatically invite candidates to a TestGorilla assessment when they reach a specific stage in your hiring pipeline.

1

Go to the Jobs page and open the relevant job.

Jobs page in Ashby
Find the job on the Jobs page
2

Click Interview Plan in the sidebar.

Interview Plan in sidebar
Click "Interview Plan" in the sidebar
3

Select the stage where you want candidates to be assessed. Click Add Activity to... and select Add Activity.

Add Activity option for a stage
Select a stage and click "Add Activity to..."
4

Under Integrations in the Add Activity panel, select TestGorilla.

Add Activity panel with TestGorilla under Integrations
Select TestGorilla under the Integrations section
5 Click Select assessment type..., choose the assessment, and click Add.
6

In the Assessment Configuration popup, click the Automation tab and toggle on Automate on Stage Entry. Candidates will now be automatically invited when they reach this stage.

Automation tab with Automate on Stage Entry toggle
Enable "Automate on Stage Entry" so candidates are invited automatically

 

View results

Once a candidate completes their assessment, the result appears in their Ashby candidate details page under the assessment activity.

Ashby candidate details showing TestGorilla assessment result
Assessment results appear in the candidate's details page once the test is completed

 

Filter candidates by score

You can filter your candidate pipeline by TestGorilla assessment score to quickly identify top performers.

1

Go to the relevant job on the Jobs page and click the Candidate Pipeline tab.

Candidate Pipeline tab on a job
Open the Candidate Pipeline tab for a job
2 Enable the Advanced toggle and click Add Field to Match.
3 Search for TestGorilla assessment score and select it.
4 Set your filtering criteria, for example score greater than or equal to 80.

 

Disable the integration

To disable the Ashby integration:

1 In TestGorilla, click your name in the top right corner and select Integrations.
2 Click Disable on the Ashby integration.
3 Click Disable on the confirmation popup.

 

Common questions

Who can set up the Ashby integration?

You need to be an Organizational Admin in Ashby and an Admin or Owner in TestGorilla to complete the setup.

I can't see the Admin tab in Ashby. What should I do?

If the Admin tab is not visible, you are not an Organizational Admin. Contact your IT department or Administrator to request access. Note that Ashby does not display who your admin is.

I forgot to copy my Ashby API Key. What now?

You can only copy the API Key once when it is first created. If you missed it, go back to Ashby, delete the key, create a new one, and then repeat Steps 4 to 6 of the setup.

Can I automatically invite candidates when they reach a stage?

Yes. Use the Automate on Stage Entry setting in the Interview Plan. See the Set up bulk invites section above.

Why aren't my TestGorilla assessments appearing in Ashby?

Make sure the API Key permissions were set correctly in Step 5. Both Api Keys (Read) and Candidates (Write) must be enabled. If the issue persists, contact TestGorilla support.

Was this article helpful?

Articles in this section

See more