Send document for signing
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.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. UseGET /api/v1/approversto list eligible approvers.
Prerequisites:
- Document must have at least one signer added via
POST /documents/{id}/signersor when creating the document - Each signer's delivery method (
EMAIL,SMS, orNONE) 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 anapproverIdto submit for approval.
What happens when you send:
- Document status changes from
DRAFTtoPENDING - Signing invitations are sent to each signer based on their individual
deliveryMethodsetting - Signers with
deliveryMethod: NONEwon't receive notifications - use their signing URLs directly
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringIdempotency-Key?stringMakes 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.
length <= 255Body
application/json- body
Send document for signing. If you lack permission to send directly, provide an approverId to submit for approval instead.
customMessage?stringOptional 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?stringUser ID of the approver. Required if you do not have SEND_WITHOUT_APPROVAL permission. Use GET /api/v1/approvers to list eligible approvers.
200
application/json- response
id*stringUnique document identifier
externalId?|Your external reference ID for this document
expiresAt?|Date and time when the document expires
date-timename*stringDocument name/title
status*stringDocument status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED
documentMeta?|Document metadata including subject, message, signing order, etc.
createdAt*stringDate and time when the document was created
date-timeupdatedAt*stringDate and time when the document was last updated
date-timecompletedAt?|Date and time when all signers completed signing
date-timecurl -X POST 'https://app.sajn.se/api/v1/documents/string/send' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{}'{ "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?