Listar Tags

GET /external/v1/tags

Retorna todas as tags da sua conta com a contagem de uso (numero de contatos que possuem a tag).

Autenticacao

Requer permissao tags:read.

Requisicao

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/tags" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/tags', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});

console.log(response.data);

Python

import requests

response = requests.get(
    'https://app.getraze.com/external/v1/tags',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Resposta

{
  "success": true,
  "data": [
    {
      "id": "tag_01",
      "name": "decision-maker",
      "color": "purple",
      "created_at": "2026-01-10T08:00:00Z",
      "usage_count": 42
    }
  ]
}

Campos de Resposta

Campo	Tipo	Descricao
id	string	Identificador da tag
name	string	Nome da tag
color	string	Cor da tag
created_at	string	Timestamp ISO 8601 de criacao
usage_count	integer	Numero de contatos com esta tag