Send Session
Send a draft session: the session transitions to pending and signing invitations are emailed to the recipients. This completes the create-review-send flow: create a draft with Create Session or Create Session From Template, review it at the returned draftUrl, then send it here. If the session has an expiryDays setting, the expiry date starts counting from the moment it is sent. To resend an invitation on an already-sent session, use Send Invitation instead.
Endpoint
POST https://api.airsign.com.au/api/v1/Session/{sessionId}/SendHeaders
| Name | Value | Required | Description |
|---|---|---|---|
| Authorization | Bearer {access_token} | Yes | Bearer token with the write:sessions scope |
Request Body
No request body is required.
Example Request
curl --location --request POST 'https://api.airsign.com.au/api/v1/Session/{uuid}/Send' \
--header 'Authorization: Bearer {access_token}'Response
Status: 200 OK
{
"sessionId": "{uuid}",
"status": "pending",
"sentAt": "2026-06-12T10:30:00.000Z",
"recipients": [
{ "recipientId": "{uuid}", "name": "Ada Lovelace", "email": "{valid_email}", "signingOrder": 1 }
]
}Error Responses
| Status | Description |
|---|---|
400 | Session is not a draft (NOT_A_DRAFT), has no recipients (NO_RECIPIENTS), recipients are missing a name or email (INCOMPLETE_RECIPIENTS - finish the draft in the editor), or the session is self-sign only (SELF_SIGN_ONLY) |
401 | Missing or invalid authentication token |
404 | Session not found |