Skip to Content

Create a new template

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/templates

Create a new template in your workspace.

Required Fields:

  • name - Template name

Optional Fields:

  • initialFields - Array of fields to create with the template. Each field has type, position, and fieldMeta.

Usage: After creating a template, add default parties via POST /api/v1/templates/:id/parties and tags via POST /api/v1/templates/:id/tags. Then create documents from it using POST /api/v1/documents with templateId.

Authorization

headerAuthorizationBearer <token>

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

Header Parameters

authorization*string

Bearer token for API authentication

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.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Create template request

name*string

Template name/title

Length1 <= length
initialFields*array<>

Initial fields to create with the template

Default[]

Response Body

200

application/json
  1. response
id*string

Unique template identifier

name*string

Template name/title

workspaceId*|

Workspace ID this template belongs to

organizationId*|

Organization ID this template belongs to

createdById*string

User ID of the template creator

isGlobal*boolean

Whether this is a global template

templateMeta?|

Template metadata with default settings

createdAt*string

Date and time when the template was created

Formatdate-time
updatedAt*string

Date and time when the template was last updated

Formatdate-time
Example Request
curl -X POST 'https://app.sajn.se/api/v1/templates' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "initialFields": []}'
Example Response
{  "id": "string",  "name": "string",  "workspaceId": "string",  "organizationId": "string",  "createdById": "string",  "isGlobal": true,  "templateMeta": {    "signingOrder": "PARALLEL",    "forceReadFullDocument": true,    "showChatToSigners": true,    "preferredLanguage": "sv",    "value": "string",    "signableAfterExpired": true,    "sendPlainTextEmailOnly": true,    "allowDelegation": true,    "reminderIntervalDays": "string",    "responsibleUserId": "string",    "accessVerification": "NONE",    "internalRecipients": [      "string"    ],    "visibility": "EVERYONE",    "selectedUserIds": [      "string"    ],    "ssnDisplayMode": "FULL",    "sameDeviceSigning": true,    "documentCategoryId": "string"  },  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Was this page helpful?