Create Tag

POST /tags

Create a new tag for your account.

Request Body

Field	Type	Required	Description
name	string	Yes	Tag display name
slug	string	Yes	URL-friendly identifier. Must be unique within your account
description	string	No	Tag description

Example

curl -X POST https://api.getnexor.ai/api/public/tags \
  -H "Content-Type: application/json" \
  -H "X-API-Key: nxr_live_your_api_key" \
  -d '{
    "name": "VIP Client",
    "slug": "vip-client",
    "description": "High-priority leads"
  }'

Responses

201 — Tag created successfully

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "name": "VIP Client",
    "slug": "vip-client",
    "description": "High-priority leads",
    "created_at": "2026-01-15T09:00:00Z"
  }
}

400 — Validation error

{
  "error": "Tag name is required"
}

Other validation errors:

• "Tag slug is required"

401 — Authentication error

See Authentication.

409 — Conflict

{
  "error": "A tag with this slug already exists"
}

500 — Internal server error