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}},{{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.
Prerequisites:
- Document must have at least one signer added via
POST /documents/{id}/partiesor when creating the document - Each signer's delivery method (
EMAIL,SMS, orNONE) and signature type (DRAWING,SE_BANKID,CLICK_TO_SIGN) are configured per-signer when adding them
Responses:
- 200 - The document is sent. Returns the document in the same shape as
GET /api/v1/documents/{id}, withoutfields. - 409 with
code: "APPROVAL_REQUIRED"- You lack theSEND_WITHOUT_APPROVALpermission, so the document needs an approval first. Request one withPOST /api/v1/approval-requests; the document is sent when it's approved. - 409 with
code: "INVALID_STATE"- The document isn't a draft, or its approval request is still pending.
Approved documents: A document whose approval request is APPROVED but that wasn't sent automatically (autoSend false) stays PENDING_APPROVAL. The user who requested the approval sends it with this endpoint, and the invitation uses the message stored on the approval request.
What happens when you send:
- Document status changes from
DRAFTtoPENDING - sajn sends each party an invitation through the channels in its
delivery - A party with
delivery: []gets no invitation, so share its signing URL yourself
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe document ID.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-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 the document for signing.
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.
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""PENDING_APPROVAL""PENDING""COMPLETED""EXPIRED""CANCELLED""REJECTED""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-timedeletedAt*|Date and time when the document moved to the trash, or null when it isn't in the trash
date-timetemplateId*|ID of the template the document was created from, or null
folderId*|ID of the folder that holds the document, or null at the top level
responsibleUserId*|ID of the workspace member responsible for the document
parties*array<>Array of document parties (signers and other participants).
tags*array<>customFields*array<>content*array<>|Content blocks in position order when you pass expand=content, and null otherwise. See the content endpoints for the per-type shapes.
productTables*array<>Every product table on the document, resolved: each row carries the recipient's final selected state and quantity, and the totals count the selected rows only. Empty when the document has no product table.
approvalRequestId*|ID of the document's approval request, or null when it has none. To read it, call GET /api/v1/approval-requests/{id}.
bundleId*|ID of the bundle the document was sent in, or null. Every document in a bundle also fires its own events, so this is the key that groups them. To read the bundle, call GET /api/v1/bundles/{id}.
curl -X POST 'https://app.sajn.se/api/v1/documents/cm4k2x9p10003abcd1234efgh/send' \ -H 'Content-Type: application/json' \ -d '{ "customMessage": "Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID."}'{ "id": "cm4k2x9p10003abcd1234efgh", "externalId": "HR-2026-0142", "expiresAt": "2026-10-28T22:00:00.000Z", "name": "Anställningsavtal – Kai Lindqvist", "status": "PENDING", "documentMeta": { "subject": "Ditt anställningsavtal från Exempelbolaget AB", "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.", "signingMode": "PARALLEL", "forceReadFullDocument": false, "showChatToSigners": false, "language": "sv", "value": "540000", "redirectUrl": null, "redirectEnabled": true, "internalRecipients": [ "hr@example.com" ], "signableAfterExpired": false, "sendPlainTextEmailOnly": false, "reminderIntervalDays": 3, "allowDelegation": false, "openVerification": "PIN", "aiChatEnabled": false, "nationalIdDisplayMode": "FULL", "sameDeviceSigning": false, "documentCategoryId": "cm4k2x9p10017abcd1234efgh" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:15:00.000Z", "completedAt": null, "deletedAt": null, "templateId": "cm4k2x9p10008abcd1234efgh", "folderId": "cm4k2x9p10011abcd1234efgh", "responsibleUserId": "cm4k2x9p10002abcd1234efgh", "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "email": "kai@example.com", "name": "Kai Lindqvist", "phone": "+46701740605", "type": "INDIVIDUAL", "company": null, "externalId": "HR-2026-0142", "contactId": "cm4k2x9p10006abcd1234efgh", "nationalId": "191212121212", "country": "SE", "role": "SIGNER", "signingOrder": 1, "signedAt": "2026-09-29T07:41:00.000Z", "readStatus": "READ", "signingStatus": "SIGNED", "delivery": [ "EMAIL" ], "signatureMethod": "SE_BANKID", "signVerification": "PIN", "openVerification": "PIN", "sendStatus": "DELIVERED", "identityVerified": true, "identityMismatch": false, "createdAt": "2026-09-28T09:12:00.000Z" } ], "tags": [ { "id": "cm4k2x9p10010abcd1234efgh", "name": "Anställning", "color": "#16A34A" } ], "customFields": [ { "id": "cm4k2x9p10016abcd1234efgh", "name": "Startdatum", "type": "TEXT", "value": "2026-11-01" } ], "content": [ { "id": "cm4k2x9p10009abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "templateId": null, "type": "TEXT", "position": 0, "fieldMeta": { "type": "TEXT", "content": "<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:12:00.000Z" } ], "productTables": [ { "fieldId": "cm4k2x9p10009abcd1234efgh", "name": "Anställningsavtal – Kai Lindqvist", "currency": "SEK", "language": "sv", "allowSelection": false, "selectionPartyId": "cm4k2x9p10004abcd1234efgh", "selectionRequired": false, "sections": [ { "id": "cm4k2x9p10037abcd1234efgh", "name": "Utbildningar", "pickOne": false } ], "rows": [ { "id": "cm4k2x9p10036abcd1234efgh", "sku": "UTB-INTRO", "name": "Introduktionsutbildning", "description": "Introduktionsutbildning.", "unit": "st", "price": 4500, "vat": 25, "billing": "ONE_TIME", "discount": { "type": "PERCENT", "value": 1 }, "optional": false, "selected": false, "quantity": 1, "lineTotal": 1, "lineNet": 1, "lineVat": 1, "sectionId": "cm4k2x9p10037abcd1234efgh", "productType": "GOODS" } ], "totals": { "subtotal": 4500, "discountAmount": 1, "vatAmount": 1125, "total": 1, "rotDeduction": 1, "rutDeduction": 1, "payable": 5625, "byBilling": { "ONE_TIME": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "MONTHLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "QUARTERLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "YEARLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 } } } } ], "approvalRequestId": "cm4k2x9p10003abcd1234efgh", "bundleId": "cm4k2x9p10044abcd1234efgh"}Was this page helpful?