Create a new template

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.

POST /api/v1/templates

Create a new template

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/templates \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>",
  "initialFields": []
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "workspaceId": "<string>",
  "organizationId": "<string>",
  "createdById": "<string>",
  "isGlobal": true,
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "templateMeta": {
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "value": "<string>",
    "signableAfterExpired": true,
    "sendPlainTextEmailOnly": true,
    "allowDelegation": true,
    "reminderIntervalDays": "<string>",
    "responsibleUserId": "<string>"
  }
}

Headers

authorization · string · required

Bearer token for API authentication

Body

application/json

Body

Create template request

name · string · required

Template name/title

Minimum string length: 1

initialFields · object[] · required

Initial fields to create with the template

Show child attributes

Response

200

application/json

200

id · string · required

Unique template identifier

name · string · required

Template name/title

workspaceId · string | null · required

Workspace ID this template belongs to

organizationId · string | null · required

Organization ID this template belongs to

createdById · string · required

User ID of the template creator

isGlobal · boolean · required

Whether this is a global template

createdAt · any · required

Date and time when the template was created

updatedAt · any · required

Date and time when the template was last updated

templateMeta · object

Template metadata with default settings

Show child attributes