Send document for signing

Send a document to signers for signing.

Request Body:

• customMessage (optional) - Custom message to include in the signing invitation emails/SMS. Supports newline characters (\n) for line breaks. Available template variables (use {{variableName}} syntax): {{firstName}}, {{lastName}}, {{fullName}}, {{recipientFirstName}}, {{recipientLastName}}, {{recipientFullName}}, {{recipientEmail}}, {{recipientPhone}}, {{senderFirstName}}, {{senderLastName}}, {{senderFullName}}, {{senderEmail}}, {{documentName}}, {{signUrl}}.
• approverId (optional) - User ID of the approver. Required if you lack the SEND_WITHOUT_APPROVAL permission. Use GET /api/v1/approvers to list eligible approvers.

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

Responses:

• 200 - Document sent directly. Status changes from DRAFT to PENDING.
• 202 - Document submitted for approval. Status changes from DRAFT to PENDING_APPROVAL. The designated approver must approve before the document is sent.
• 403 with code: "APPROVAL_REQUIRED" - You lack permission to send directly. Provide an approverId to submit for approval.

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>",
  "approverId": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "externalId": "<string>",
  "expiresAt": "<string>",
  "documentMeta": {
    "subject": "<string>",
    "message": "<string>",
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "value": "<string>",
    "redirectUrl": "<string>",
    "redirectEnabled": true
  },
  "completedAt": "<string>"
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

Body

application/json

Body

Send document for signing. If you lack permission to send directly, provide an approverId to submit for approval instead.

customMessage · string

Optional custom message to include in the signing invitation. Supports newline characters (\n) for line breaks. Available template variables (use {{variableName}} syntax): {{firstName}}, {{lastName}}, {{fullName}}, {{recipientFirstName}}, {{recipientLastName}}, {{recipientFullName}}, {{recipientEmail}}, {{recipientPhone}}, {{senderFirstName}}, {{senderLastName}}, {{senderFullName}}, {{senderEmail}}, {{documentName}}, {{signUrl}}.

approverId · string

User ID of the approver. Required if you do not have SEND_WITHOUT_APPROVAL permission. Use GET /api/v1/approvers to list eligible approvers.

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 · any · required

Date and time when the document was created

updatedAt · any · required

Date and time when the document was last updated

externalId · string | null

Your external reference ID for this document

expiresAt · string | null

Date and time when the document expires

documentMeta · object

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

Show child attributes

completedAt · string | null

Date and time when all signers completed signing