Ashby Integration
Run Aperture's AI interview assessment inside an Ashby hiring pipeline via Assessments Partner API.
Scope not finalized
The exact minimal write scope for assessment.update hasn't been isolated
on our side yet. This guide currently documents it as needing broad
assessment write access. Confirm the exact scope before publishing this
page externally.
What it does
Aperture's AI interview assessment runs inside a company's existing Ashby pipeline via Ashby's Assessments Partner API. Recruiters don't leave Ashby, and candidates don't see a separate vendor: Aperture shows up as an assessment stage like any other.
How to enable it
- A recruiter selects "Aperture AI Interview" as an assessment type on a job in Ashby.
- Once a candidate reaches that stage, Ashby sends an
assessment.startwebhook to Aperture.
That webhook is the only trigger Aperture needs. Everything after it is automatic.
What happens automatically
Once Aperture receives assessment.start for a candidate, it:
- Creates the candidate record in Aperture.
- Runs a resume screen against the job's requirements.
- If the candidate clears the resume-screen threshold, auto-invites them to an AI voice interview by email.
No manual step is required from the recruiting team between the candidate reaching the assessment stage and the interview invite going out.
After the interview
Once the candidate completes the AI voice interview, Aperture:
- Scores the interview.
- Ranks the candidate against others in the same pool.
- Writes the result back to the same assessment card in Ashby via
assessment.update.
How the result is presented:
- With 2 or more candidates in the pool, Aperture shows the candidate's literal rank in the pool (e.g. "3rd of 14"), not a percentile.
- With a single-candidate pool, rank isn't meaningful yet, so Aperture shows a raw composite score instead.
Setup requirements
The customer generates an Ashby API key with the following scopes:
| Scope | Why Aperture needs it |
|---|---|
jobsRead | Read job details to configure the assessment and resume screen |
hiringProcessMetadataWrite | Set per-job interview language/type configuration |
| Departments read | Org sync |
| Locations read | Org sync |
| Team members read | Org sync |
| Assessment write access | Write interview results back via assessment.update (see the scope note above) |
Optional configuration
Recruiters can set interview language and interview type per job via Ashby custom fields that Aperture provisions automatically when the integration is installed. No manual custom-field setup is required.
Last Updated September 01, 2026