Skip to Content

Send document for signing

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/documents/{id}/send

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}}, {{recipientCompanyName}}, {{recipientCompanyRole}}, {{recipientCompanyOrgNumber}}, {{recipientRole}}, {{senderFirstName}}, {{senderLastName}}, {{senderFullName}}, {{senderEmail}}, {{senderCompanyName}}, {{documentName}}, {{documentId}}, {{documentValue}}, {{documentCreatedDate}}, {{expirationDate}}, {{signUrl}}. Custom fields are available as {{custom.<field-slug>}} using the slugified field name (e.g. "Avtalsdatum (demo)" becomes {{custom.avtalsdatum-demo}}); secured fields are excluded.
  • 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

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Path Parameters

id*string

Header Parameters

authorization*string

Bearer token for API authentication

Idempotency-Key?string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Lengthlength <= 255

Request Body

Body

application/json
  1. 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}}, {{recipientCompanyName}}, {{recipientCompanyRole}}, {{recipientCompanyOrgNumber}}, {{recipientRole}}, {{senderFirstName}}, {{senderLastName}}, {{senderFullName}}, {{senderEmail}}, {{senderCompanyName}}, {{documentName}}, {{documentId}}, {{documentValue}}, {{documentCreatedDate}}, {{expirationDate}}, {{signUrl}}. Custom fields are available as {{custom.}} using the slugified field name (e.g. "Avtalsdatum (demo)" becomes {{custom.avtalsdatum-demo}}); secured fields are excluded.

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 Body

200

application/json
  1. response
id*string

Unique document identifier

externalId?|

Your external reference ID for this document

expiresAt?|

Date and time when the document expires

Formatdate-time
name*string

Document name/title

status*string

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

documentMeta?|

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

createdAt*string

Date and time when the document was created

Formatdate-time
updatedAt*string

Date and time when the document was last updated

Formatdate-time
completedAt?|

Date and time when all signers completed signing

Formatdate-time
Example Request
curl -X POST 'https://app.sajn.se/api/v1/documents/string/send' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "externalId": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "name": "string",  "status": "string",  "documentMeta": {    "subject": "string",    "message": "string",    "signingOrder": "PARALLEL",    "forceReadFullDocument": true,    "showChatToSigners": true,    "preferredLanguage": "sv",    "value": "string",    "redirectUrl": "string",    "redirectEnabled": true,    "internalRecipients": [      "string"    ],    "signableAfterExpired": true,    "sendPlainTextEmailOnly": true,    "reminderIntervalDays": "string",    "allowDelegation": true,    "accessVerification": "NONE",    "aiChatEnabled": true,    "ssnDisplayMode": "FULL",    "sameDeviceSigning": true,    "documentCategoryId": "string"  },  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "completedAt": "2019-08-24T14:15:22Z"}

Was this page helpful?