Send document for signing

Send a document to signers for signing. The document status will change from DRAFT to PENDING.

Request Body:

• customMessage (optional) - Custom message to include in the signing invitation emails/SMS

Prerequisites:

• Document must have at least one signer added via POST /documents/{id}/signers or when creating the document
• Each signer’s delivery method (EMAIL, SMS, or NONE) and signature type (DRAWING, BANKID, CLICK_TO_SIGN) are configured per-signer when adding them

What happens when you send:

1. Document status changes from DRAFT to PENDING
2. Signing invitations are sent to each signer based on their individual deliveryMethod setting
3. Signers with deliveryMethod: NONE won’t receive notifications - use their signing URLs directly

POST /api/v1/documents/{id}/send

Send document for signing

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/documents/{id}/send \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "customMessage": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "documentMeta": {
    "subject": "<string>",
    "message": "<string>",
    "signingOrder": "PARALLEL",
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "preferredLanguage": "sv",
    "value": "<string>",
    "redirectUrl": "<string>",
    "redirectEnabled": true
  },
  "completedAt": "2023-11-07T05:31:56Z"
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

Body

application/json

Body

Send document for signing.

customMessage · string

Optional custom message to include in the signing invitation

Response

200

application/json

200

id · string · required

Unique document identifier

name · string · required

Document name/title

status · string · required

Document status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED

createdAt · string<date-time> · required

Date and time when the document was created

updatedAt · string<date-time> · required

Date and time when the document was last updated

externalId · string | null

Your external reference ID for this document

expiresAt · string<date-time> | null

Date and time when the document expires

documentMeta · object

Document metadata including subject, message, signing order, etc.

Show child attributes

completedAt · string<date-time> | null

Date and time when all signers completed signing