Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sajn.se/llms.txt

Use this file to discover all available pages before exploring further.

​
Creating Documents

Learn how to create documents with various configurations for different use cases.

​
Basic Document Creation

Create a simple document in draft status: 
curl -X POST https://app.sajn.se/api/v1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Employment Contract - John Doe",
    "type": "SIGNABLE"
  }'
Response: 
{
  "documentId": "doc_123abc",
  "externalId": null,
  "expiresAt": null,
  "signers": []
}

​
Adding Signers During Creation

Include signers when creating the document. Each signer can have their own delivery method and signature type: 
{
  "name": "Employment Contract",
  "type": "SIGNABLE",
  "signers": [
    {
      "name": "John Doe",
      "email": "john@example.com",
      "role": "SIGNER",
      "signingOrder": 1,
      "deliveryMethod": "EMAIL",
      "requiredSignature": "DRAWING"
    },
    {
      "name": "Jane Manager",
      "email": "jane@example.com",
      "role": "SIGNER",
      "signingOrder": 2,
      "deliveryMethod": "EMAIL",
      "requiredSignature": "BANKID",
      "twoStepVerification": "SMS_BEFORE_SIGNING"
    }
  ]
}
The response includes signer IDs: 
{
  "documentId": "doc_123",
  "signers": [
    {
      "signerId": "signer_1",
      "type": "INDIVIDUAL",
      "name": "John Doe",
      "email": "john@example.com",
      "contactId": null
    }
  ]
}
To retrieve a signer’s signing URL, use GET /api/v1/documents/{id}/signers/{signerId}. This endpoint returns the complete signing URL with token.

​
Company Signers and SMS Delivery

Create documents with company signers and SMS delivery with two-step verification: 
{
  "name": "Business Contract",
  "type": "SIGNABLE",
  "signers": [
    {
      "type": "INDIVIDUAL",
      "name": "John Doe",
      "phone": "+46701234567",
      "role": "SIGNER",
      "signingOrder": 1,
      "deliveryMethod": "SMS",
      "requiredSignature": "DRAWING",
      "twoStepVerification": "SMS_BEFORE_SIGNING"
    },
    {
      "type": "COMPANY",
      "name": "Jane Smith",
      "email": "jane@company.com",
      "companyName": "Acme Corp",
      "companyOrgNumber": "556123-4567",
      "role": "SIGNER",
      "signingOrder": 2,
      "deliveryMethod": "EMAIL",
      "requiredSignature": "BANKID"
    }
  ]
}
For SMS verification before signing, use twoStepVerification: "SMS_BEFORE_SIGNING" combined with your chosen signature type.

​
Setting Document Metadata

Configure signing workflow and notifications: 
{
  "name": "Service Agreement",
  "type": "SIGNABLE",
  "documentMeta": {
    "subject": "Please sign the service agreement",
    "message": "Thank you for choosing our services. Please review and sign the attached agreement.",
    "signingOrder": "SEQUENTIAL",
    "forceReadFullDocument": true,
    "preferredLanguage": "sv"
  }
}
Delivery method and signature type are configured per-signer, not at the document level. See Adding Signers above.

​
Setting Expiration

Make the document expire after 30 days: 
{
  "name": "Time-Sensitive Agreement",
  "expiresAt": "2024-12-31T23:59:59Z"
}

​
Using External IDs

Link to your own system: 
{
  "name": "Contract #12345",
  "externalId": "contract_12345_from_my_crm"
}

​
Creating from Templates

Use a template to pre-populate fields: 
{
  "name": "Employment Contract - John Doe",
  "templateId": "template_abc123"
}

​
Template Workflow with Form Fields

When creating documents from templates that contain FORM fields with keys, you can fill those fields programmatically. Here’s the complete workflow:
  1. Create document from template (this creates a copy of template fields)
  2. Fill form fields using key-based updates: PATCH /api/v1/documents/{docId}/fields/key:{fieldKey}
  3. Send for signing: POST /api/v1/documents/{docId}/send
Example: 
# Step 1: Create from template with signers
curl -X POST https://app.sajn.se/api/v1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Employment Contract",
    "templateId": "template_abc123",
    "signers": [{
      "name": "John Doe",
      "email": "john@example.com",
      "role": "SIGNER",
      "deliveryMethod": "EMAIL",
      "requiredSignature": "BANKID"
    }]
  }'

# Step 2: Fill a form field by its key
curl -X PATCH https://app.sajn.se/api/v1/documents/doc_123/fields/key:employee_name \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fieldMeta": {"type": "input", "value": "John Doe"}}'

# Step 3: Send for signing
curl -X POST https://app.sajn.se/api/v1/documents/doc_123/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Delivery method and signature type are configured per-signer when adding them, not at send time.
For more details on updating fields, see Update Document Field.

​
Adding Custom Fields

Include custom field values during creation: 
{
  "name": "Project Agreement",
  "customFields": [
    {
      "customInputId": "field_project_name",
      "value": "Website Redesign"
    },
    {
      "customInputId": "field_budget",
      "value": "50000"
    }
  ]
}

​
Complete Example: Business Contract

Here’s a complete example creating a business contract with all features: 
{
  "name": "Service Agreement - Acme Corp",
  "type": "SIGNABLE",
  "externalId": "agreement_2024_001",
  "expiresAt": "2024-02-15T23:59:59Z",
  "documentMeta": {
    "subject": "Service Agreement for Your Review",
    "message": "Please review and sign this service agreement. Contact us if you have any questions.",
    "signingOrder": "SEQUENTIAL",
    "forceReadFullDocument": true,
    "showCommentsToSigners": true,
    "preferredLanguage": "sv",
    "validFrom": "2024-01-01T00:00:00Z",
    "validTo": "2024-12-31T23:59:59Z",
    "value": "500000"
  },
  "signers": [
    {
      "name": "Jane Manager",
      "email": "jane@company.com",
      "role": "SIGNER",
      "signingOrder": 1,
      "deliveryMethod": "EMAIL",
      "requiredSignature": "DRAWING"
    },
    {
      "name": "John Client",
      "email": "john@acme.com",
      "role": "SIGNER",
      "signingOrder": 2,
      "deliveryMethod": "EMAIL",
      "requiredSignature": "BANKID",
      "twoStepVerification": "SMS_BEFORE_SIGNING"
    }
  ],
  "customFields": [
    {
      "customInputId": "project_name",
      "value": "Digital Transformation"
    },
    {
      "customInputId": "department",
      "value": "IT"
    }
  ]
}

​
Next Steps

File Uploads

Upload PDF files to add to your documents

Send for Signing

Learn how to send documents to signers

Signer-Fillable Fields

Let signers fill in fields during signing

Document Fields

Add form fields and content sections

API Reference

Complete API reference for creating documents