curl -X POST https://crm.vistum.com.br/api/v1/tags \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "vip", "color": "#f59e0b" }'
{ "data": { "id": "tag_vip99", "name": "vip", "color": "#f59e0b", "createdAt": "2026-07-21T18:00:00.000Z" } }
Tags
Criar tag
Cria uma nova etiqueta (tag) colorida no workspace.
POST
/
api
/
v1
/
tags
curl -X POST https://crm.vistum.com.br/api/v1/tags \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "vip", "color": "#f59e0b" }'
{ "data": { "id": "tag_vip99", "name": "vip", "color": "#f59e0b", "createdAt": "2026-07-21T18:00:00.000Z" } }
Autenticação
string
required
Bearer vg_live_<sua_chave> — API Key com escopo tags:writeBody
string
required
Nome da tag (até 64 caracteres).
string
Cor em hex de 6 dígitos, ex:
#22c55e. Padrão: #22c55e.curl -X POST https://crm.vistum.com.br/api/v1/tags \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "vip", "color": "#f59e0b" }'
{ "data": { "id": "tag_vip99", "name": "vip", "color": "#f59e0b", "createdAt": "2026-07-21T18:00:00.000Z" } }
400 VALIDATION (nome/cor inválidos), 409 TAG_EXISTS (já existe tag com esse nome).