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.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
Authorizations
Headers
Body
Body
Send document for signing. If you lack permission to send directly, provide an approverId to submit for approval instead.
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.
Response
200

