Skip to main content
The Ashby integration lets your team run Equip without leaving Ashby. You add an Equip assessment or AI interview to a job’s interview plan, start it for a candidate from Ashby, and Ashby shows the status and score on the candidate’s profile as soon as Equip has them.

​
Connecting Ashby to Equip

You need to be an Owner or Admin in Equip, and an admin in Ashby.
1

Create an API key for Equip in Ashby

In Ashby, open Admin → Integrations and find the Equip tile under Assessments. Create a key in the Ashby API Key field and copy it.
2

Paste the key into Equip

In Equip, go to Account → Integrations → Ashby, paste the key, and click Connect.
3

Copy the Equip secret

Equip shows your Equip secret together with the partner base URL. Copy the secret straight away: it is shown only once.
4

Enable the integration in Ashby

Back on the Equip tile in Ashby, paste the Equip secret into the Equip API Key field, choose the Ashby key you created in the first step, and enable the integration.
The Equip tile in Ashby with its key fields filled in
5

Test the connection

In Equip, click Test connection on the Ashby page.
Equip's Ashby integration page showing Connected

The Ashby page in Equip once connected

If you close the secret dialog without copying the secret, click Rotate on the Ashby page in Equip to get a new one. Rotating replaces the old secret, so paste the new one into Ashby before Ashby next calls Equip.

​
Using Equip from Ashby

1

Add Equip to an interview plan

Open the job’s Interview Plan in Ashby, click Add Activity on the stage where the assessment belongs, and choose Equip under Integrations.
Ashby's Add Activity panel with Equip listed under Integrations

Equip in Ashby's Add Activity panel

Then pick the assessment or AI interview. Ashby lists everything active in your Equip account, named as opening number · job title · stage.
Ashby's Add Equip Activity panel with the assessment picker open

Picking the Equip assessment for the stage

An Ashby interview plan stage with an Equip Assessment activity

An Equip assessment on the Technical Quiz stage

2

Start it for a candidate

When a candidate reaches that stage, start the assessment from their Ashby profile. Equip emails the candidate the invitation, and the status and score appear on the same profile.
The invitation is the email set up for that stage or assessment in Equip, otherwise Equip’s default. Replies go to the first member of the job’s hiring team in Ashby.

​
What Ashby shows on the candidate

Equip writes only to the candidate’s Ashby profile.
A completed Equip Assessment activity with scores on an Ashby candidate profile

A completed Equip assessment on a candidate's Ashby profile

The full report, with answers, recordings and proctoring evidence, stays in Equip behind the View in Equip link.

​
Cancelling an assessment

Cancel from Ashby, not from Equip.
Starting the same assessment twice for the same application is refused while the first one is open. Cancel it first, or wait for it to complete.

​
Troubleshooting

The Equip secret in Ashby is missing or out of date. Open the Ashby page in Equip, click Rotate to get a new secret, and paste it into Ashby.
Click Test connection on the Ashby page in Equip. If Ashby rejects the key, or the key cannot write to candidates, create a new key from the Equip tile in Ashby and click Update key in Equip. Results arrive within about a minute of scoring; an attempt that needs manual grading is reported once you finalize the grade.
Ashby shows the reason. The usual ones are: the candidate has no email address in Ashby; the assessment was archived or deleted in Equip; your Equip plan no longer includes integrations.
Disconnecting removes the stored keys. Reconnect by pasting a key from Ashby again; Equip issues a new secret, which you paste into Ashby.
  • Webhooks - send completion events to your own systems
  • Trust Score - what the proctoring score on the candidate means
  • Manual Grading - how attempts that need a human grade reach their final score
  • How Credits Work - what an assessment started from Ashby costs