Skip to main content
POST
Post Org Tag

Auth

Requires a CRM manage scope and an active organization on the token. Any *:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.

Response

Returns the created tag row — same shape as one element of tags[] in the List Tags response.

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Tag label, unique per org.

Required string length: 1 - 120
color
string | null

Chip color, conventionally a hex code (e.g. #6366f1).

Maximum string length: 32

Response

Successful Response