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.
Setup takes about five minutes and needs two things: an Ashby API key created from the Equip tile in Ashby, and an Equip secret that Equip shows you once when you connect. You paste each one into the other product.

​
Connecting Ashby to Equip

You need to be the primary admin of your Equip team, on a plan that includes integrations, 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. In the Ashby API Key field, create a key for Equip (the link icon next to the field opens Ashby’s API Credentials page). Ashby pre-selects the permissions Equip needs, including writing to candidates. Copy the key.
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 now shows your Equip secret together with the partner base URL. Copy the secret straight away: it is shown only this 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.
Ashby's Equip integration panel with the Equip API Key, Ashby API Key and base URL fields filled in

The Equip tile in Ashby once it is enabled

5

Test the connection

In Equip, click Test connection on the Ashby page. Equip checks that Ashby accepts your key and that it can write results to candidates.
Equip's Ashby integration page showing Connected, the masked Ashby API key with Update key, the masked Equip secret with Rotate, and Test connection and Disconnect Ashby buttons

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

Once connected, Equip appears as an assessment option in Ashby’s interview plans.
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, so you can tell apart assessments that belong to different jobs.
Ashby's Add Equip Activity panel with the assessment type picker open, listing Equip assessments by opening number, job title and stage

Picking the Equip assessment for the stage

A Technical Quiz stage in an Ashby interview plan with an Equip Assessment activity named 23 · Data Analyst · Data Analyst

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 Ashby shows the status Invited.
3

Follow progress in Ashby

When the candidate opens the link, the status changes to Started. When Equip has finished scoring, it changes to Completed and the score appears.
The invitation email is the one set up for that stage in Equip: the template linked to the pipeline stage, otherwise the email on the assessment’s Invite tab, 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 to the candidate’s Ashby profile at each step. Nothing else in Ashby is changed.
The Equip Assessment activity on an Ashby candidate profile showing status Completed, overall score 76.57 percent, a View in Equip link, per-test scores, trust score and time taken

A completed Equip assessment on a candidate's Ashby profile

The full report, with answers, recordings and proctoring evidence, stays in Equip. The View in Equip link on the candidate’s Ashby profile opens it.

​
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. Fix the cause in Equip or Ashby and start it again.
Disconnecting removes the stored keys, so Ashby can no longer start assessments and results stop flowing. 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