Skip to Content
CapstoneDocs

Callbacks Capstone sends

How Capstone pushes progress and results back to the ATS.

Capstone pushes updates to the ATS rather than waiting to be polled.

EventGreenhouseAshby
Candidate startsNo call. Visible on test_status.assessment.update, status Started
Results readyPATCH to the url from send_test, no body. Greenhouse then calls test_status.assessment.update with result, report URL and metadata
Recruiter cancels in CapstoneNo channel. Visible on test_status.assessment.update with cancelled_reason

Greenhouse

PATCH <url from send_test>
Authorization: Basic base64("capats_greenhouse_<48 hex>:")

Capstone only calls https URLs on greenhouse.io. The URL is checked when the order arrives and again before every call.

Ashby

POST https://api.ashbyhq.com/assessment.update
Authorization: Basic base64("<customer's Ashby API key>:")
Content-Type: application/json
Completed
{
  "assessment_id": "5b7c9e1a-2d3f-4a5b-8c6d-7e8f9a0b1c2d",
  "timestamp": 1762598527512,
  "assessment_status": { "identifier": "assessment_status", "label": "Status", "type": "string", "value": "Completed" },
  "assessment_result": { "identifier": "overall_score", "label": "Overall score", "description": "Out of 100", "type": "numeric_score", "value": 82 },
  "assessment_profile_url": { "identifier": "report_url", "label": "Capstone report", "type": "url", "value": "https://usecapstone.com/recruiter/…" },
  "metadata": [
    { "identifier": "authenticity", "label": "AI-usage assessment", "type": "string", "value": "Authentic" },
    { "identifier": "certificate_url", "label": "Certificate", "type": "url", "value": "https://usecapstone.com/verify/CAP-2026-0811" }
  ]
}

A delivery counts only when Ashby answers success: true.

Delivery and retries

  • Up to 6 attempts with exponential backoff, starting one minute apart. This covers an ATS outage of roughly an hour.
  • A non-2xx answer, a timeout, or Ashby's success: false counts as a failure and is retried.
  • Only one delivery per order is queued at a time. The recruiter or Capstone support can resend a finished result, so treat repeats as normal.

Webhooks for your own systems

Capstone does not yet offer webhook subscriptions to companies. The callbacks above go only to the ATS. If you need events in your own system, ask your Capstone contact what is planned.

On this page