Criar etiqueta

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

Cria uma etiqueta. O nome é único dentro da organização.

Escopo: tags:write
Limite de uso: Escrita · 60/min

Parâmetros do corpo

namestringobrigatório

Nome da etiqueta.

colorstringopcional

Cor em hexadecimal, por exemplo #16a34a.

Erros

400

name ausente, Invalid hexadecimal color code ou Tag with this name already exists.

Além dos erros que qualquer rota pode devolver: veja Erros.

AnteriorBuscar etiqueta Próximo Editar etiqueta

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

Resposta 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"
    }
  }
}