Skip to main content
POST
/
tags
curl -X POST 'https://api.example.com/tags' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "scopeId": "scope_acme",
    "tagGroupId": "tag_group_priority",
    "identifier": "high",
    "label": "High Priority"
  }'

{
  "id": "tag_0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "scopeId": "scope_acme",
  "tagGroupId": "tag_group_priority",
  "identifier": "high",
  "label": "High Priority",
  "createdBy": "system",
  "createdAt": "2024-01-15T10:30:00Z"
}

​
Request Body

​
id
string
Optional client-provided ID. Format: tag_{uuidv7}
​
scopeId
string
required
ID of the scope
​
tagGroupId
string
required
ID of the tag group this tag belongs to
​
identifier
string
required
Unique identifier for the tag within the group
​
label
string
required
Display label for the tag

​
Response

Returns the created tag object. 
curl -X POST 'https://api.example.com/tags' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "scopeId": "scope_acme",
    "tagGroupId": "tag_group_priority",
    "identifier": "high",
    "label": "High Priority"
  }'

{
  "id": "tag_0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "scopeId": "scope_acme",
  "tagGroupId": "tag_group_priority",
  "identifier": "high",
  "label": "High Priority",
  "createdBy": "system",
  "createdAt": "2024-01-15T10:30:00Z"
}