Skip to main content
POST
A tag always belongs to a group, and the group decides which records it can go on. Create the group first with Create Tag Group, or read an existing one from List Tag Groups.

Body

string
required
The group’s id. A group id from another workspace reads as absent, so the tag cannot be created into it.
string
required
1-50 characters.
string
required
A hex colour, e.g. #3B82F6. It is rendered through a normaliser that caps saturation and clamps lightness, so a neon value displays calmer than you sent it.
boolean
default:"false"
Opportunity (path) tags only: this tag closes the opportunity it is on. Rows carrying it sort last and draw with a neutral pill; they stay visible and filterable, because a tag never hides a row.
Position is not yours to set. A new tag goes to the end of its group. A group holds at most 50 tags.