Skip to Content
CapstoneDocs
Ashby

Start assessment

POST
/ats/ashby/assessment.start

Invite a candidate. This sends a real invitation email to the candidate address you supply.

Authorization

partnerKey
headerAuthorizationBasic <token>

An ATS partner key (capats_greenhouse_… or capats_ashby_…) as the Basic username, with an empty password. Issued once per customer connection and pasted into the ATS.

Request Body

application/json
  1. body
assessment_type_id*string
Formatuuid
candidate*
application*
job?

Response Body

Order placed.

application/json
  1. response
success?boolean
results?
Example Request
curl -X POST 'https://api.usecapstone.com/v1/ats/ashby/assessment.start' \  -H 'Content-Type: application/json' \  -d '{  "assessment_type_id": "8d2f6b0e-1c4a-4f5e-9a7d-2b3c4d5e6f70",  "candidate": {    "ashby_id": "c1a2",    "first_name": "Adaeze",    "last_name": "Okafor",    "email": "ada.okafor@example.com"  },  "application": {    "ashby_id": "a9f8"  },  "job": {    "name": "Customer Success Manager"  }}'
Example Response
{  "success": true,  "results": {    "assessment_id": "9f60a03f-b3de-4b19-9361-0380d9aa1e9e"  }}

List assessments POST

Previous Page

Assessment update (Ashby) Webhook

Sent to `https://api.ashbyhq.com/assessment.update` with the customer's own Ashby API key when the candidate starts, when results are ready, and when a recruiter cancels inside Capstone. Delivered only when Ashby answers `success: true`; otherwise retried up to 6 times with exponential backoff from one minute. A run without a numeric score reports the string `"Not scored"`.