Create a tag

POSThttps://api.batzap.com/v1/tags

Creates a tag. Names are unique within the organization.

Scope: tags:write
Rate limit: Write · 60/min

Body parameters

namestringrequired

Tag name.

colorstringoptional

Hex color, e.g. #16a34a.

Errors

400

Missing name, Invalid hexadecimal color code or Tag with this name already exists.

Plus the errors every route can return: see Errors.

PreviousGet a tag Next Update a tag

curl -X POST "https://api.batzap.com/v1/tags" \
  -H "Authorization: bzp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "VIP",
    "color": "#16a34a"
  }'

Response 200

{
  "success": true,
  "message": "Tag created successfully",
  "data": {
    "tag": {
      "id": "8c4e2a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13",
      "name": "VIP",
      "color": "#16a34a",
      "created_at": "2026-08-01T10:00:00Z",
      "updated_at": "2026-08-01T10:00:00Z"
    }
  }
}