Send document for signing

curl --request POST \
  --url https://app.sajn.se/api/v1/documents/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customMessage": "Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID."
}
'

import requests

url = "https://app.sajn.se/api/v1/documents/{id}/send"

payload = { "customMessage": "Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customMessage: 'Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.'
  })
};

fetch('https://app.sajn.se/api/v1/documents/{id}/send', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sajn.se/api/v1/documents/{id}/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customMessage' => 'Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sajn.se/api/v1/documents/{id}/send"

	payload := strings.NewReader("{\n  \"customMessage\": \"Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sajn.se/api/v1/documents/{id}/send")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customMessage\": \"Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/documents/{id}/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customMessage\": \"Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.\"\n}"

response = http.request(request)
puts response.read_body

{
  "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": [
      "[email protected]"
    ],
    "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": "[email protected]",
      "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"
}

Documents

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}/parties or when creating the document
Each signer’s delivery method (EMAIL, SMS, or NONE) 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}, without fields.
409 with code: "APPROVAL_REQUIRED" - You lack the SEND_WITHOUT_APPROVAL permission, so the document needs an approval first. Request one with POST /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 DRAFT to PENDING
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

POST

api

documents

{id}

send

Send document for signing

curl --request POST \
  --url https://app.sajn.se/api/v1/documents/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customMessage": "Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID."
}
'

import requests

url = "https://app.sajn.se/api/v1/documents/{id}/send"

payload = { "customMessage": "Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customMessage: 'Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.'
  })
};

fetch('https://app.sajn.se/api/v1/documents/{id}/send', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sajn.se/api/v1/documents/{id}/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customMessage' => 'Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sajn.se/api/v1/documents/{id}/send"

	payload := strings.NewReader("{\n  \"customMessage\": \"Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sajn.se/api/v1/documents/{id}/send")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customMessage\": \"Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/documents/{id}/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customMessage\": \"Välkommen till Exempelbolaget, Kai! Signera avtalet med BankID.\"\n}"

response = http.request(request)
puts response.read_body

{
  "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": [
      "[email protected]"
    ],
    "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": "[email protected]",
      "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"
}

Authorizations

Authorization

string

header

required

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

Headers

Sajn-Version

enum<string>

API 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.

Available options:

2026-09,

2026-10

Sajn-Workspace

string

ID 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

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.

Maximum string length: 255

Path Parameters

string

required

The document ID.

Body

application/json

Body

Send the document for signing.

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.

Response

200

string

required

Unique document identifier

externalId

string | null

required

Your external reference ID for this document

expiresAt

string<date-time> | null

required

Date and time when the document expires

name

string

required

Document name/title

status

enum<string>

required

Document status

Available options:

DRAFT,

PENDING_APPROVAL,

PENDING,

COMPLETED,

EXPIRED,

CANCELLED,

REJECTED,

IMPORTED

documentMeta

object | null

required

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

Show child attributes

createdAt

string<date-time>

required

Date and time when the document was created

updatedAt

string<date-time>

required

Date and time when the document was last updated

completedAt

string<date-time> | null

required

Date and time when all signers completed signing

deletedAt

string<date-time> | null

required

Date and time when the document moved to the trash, or null when it isn't in the trash

templateId

string | null

required

ID of the template the document was created from, or null

folderId

string | null

required

ID of the folder that holds the document, or null at the top level

responsibleUserId

string | null

required

ID of the workspace member responsible for the document

parties

object[]

required

Array of document parties (signers and other participants).

Show child attributes

Get started

Core concepts

Guides

Webhooks

API fundamentals

Upgrading

sajn Login

API reference

Send document for signing

Authorizations

Headers

Path Parameters

Body

Response