Skip to main content

​
Authentication

This endpoint requires authentication using a Bearer token. 
curl -X POST https://api.dub.co/tags \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing",
    "color": "blue"
  }'

​
Request Body

​
name
string
required
The name of the tag to create.Minimum length: 1, Maximum length: 50
​
color
string
The color of the tag. If not provided, a random color will be used.Available colors: red, yellow, green, blue, purple, pink, brown

​
Response

​
id
string
The unique ID of the tag.
​
name
string
The name of the tag.
​
color
string
The color of the tag.
{
  "id": "tag_abc123",
  "name": "Marketing",
  "color": "blue"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us