Skip to main content
POST
Create a new tag
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 tag request

name
string
required

Tag name (required)

Minimum string length: 1
availableFor
enum<string>[]
required

Where this tag can be used

Minimum array length: 1
Available options:
DOCUMENT,
TEMPLATE,
CONTACT
color
string

Tag color in hex format (e.g., #FF5733)

Pattern: ^#[0-9A-F]{6}$

Response

200

id
string
required

Unique tag identifier

name
string
required

Tag name

color
string
required

Tag color in hex format (e.g., #FF5733)

availableFor
string[]
required

Where this tag can be used: DOCUMENT, TEMPLATE, and/or CONTACT

createdAt
string<date-time>
required

Date and time when tag was created

updatedAt
string<date-time>
required

Date and time when tag was last updated