Skip to main content
POST
Create a new template
You’re viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To see the current version, select 2026-10 in the menu at the top of the sidebar. To move your integration, see Upgrading to 2026-10.

Authorizations

Authorization
string
header
required

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

Headers

authorization
string
required

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.

Maximum string length: 255

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

Response

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
string<date-time>
required

Date and time when the template was created

updatedAt
string<date-time>
required

Date and time when the template was last updated

templateMeta
object | null

Template metadata with default settings