Skip to main content
POST
Create a tag

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Headers

Idempotency-Key
string

Retry-safe key; a repeat of the same request replays the first response

Maximum string length: 255

Body

application/json

A manual tag. name is required on create; on update send only what changes.

name
string
Required string length: 1 - 100
color
string | null
Pattern: ^#[0-9a-fA-F]{6}$

Response

Tag created

id
integer
name
string
type
enum<string>

manual: put on by people. system: a smart tag, applied from the smart tag rules. interest: applied from what a person books.

Available options:
manual,
system,
interest
color
string | null

Hex colour, e.g. #3b82f6

contactCount
integer

How many contacts carry it now