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}/Send

Headers

NameValueRequiredDescription
AuthorizationBearer {access_token}YesBearer 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

StatusDescription
400Session 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)
401Missing or invalid authentication token
404Session not found