Skip to main content
POST /tags Create a new tag for your account.

Request Body

FieldTypeRequiredDescription
namestringYesTag display name
slugstringYesURL-friendly identifier. Must be unique within your account
descriptionstringNoTag 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

Last modified on June 18, 2026