Skip to Content
CapstoneDocs
Greenhouse

Send test

POST
/ats/greenhouse/send_test

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

Idempotent on application id + test id: repeating the call while the order is open returns the same partner_interview_id and sends no second email. An order that was cancelled or failed is reopened.

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
partner_test_id*string
Formatuuid
candidate*
application*
url*string

Greenhouse callback URL. Must be https on greenhouse.io.

Formaturi
sent_by?string

Response Body

Order placed.

application/json
  1. response
partner_interview_id?string
Formatuuid
Example Request
curl -X POST 'https://api.usecapstone.com/v1/ats/greenhouse/send_test' \  -H 'Content-Type: application/json' \  -d '{  "partner_test_id": "8d2f6b0e-1c4a-4f5e-9a7d-2b3c4d5e6f70",  "candidate": {    "id": 4810293,    "first_name": "Adaeze",    "last_name": "Okafor",    "preferred_name": "Ada",    "email": "ada.okafor@example.com"  },  "application": {    "id": 99210441  },  "url": "https://api.greenhouse.io/v1/partner/test_status/example",  "sent_by": "recruiter@customer.com"}'
Example Response
{  "partner_interview_id": "ed4eff5b-6b7b-41d5-8ce8-f063d04bf8ca"}