# Etiquetas

> Etiquetas da conta e dos contatos.

Endereço: https://docs.nextags.com.br/referencia/etiquetas/
Tipo: Referência

As etiquetas marcam contatos para separar, filtrar e disparar automações, como `cliente-vip` ou `lead-quente`. Crie e consulte as etiquetas da conta e ponha ou tire cada uma de um contato. Na conta, elas ficam em **Fluxos** › **Etiquetas**, e o ID de cada uma sai do menu **⋮** › **Obter ID**: veja [Criar e usar etiquetas](https://help.nextags.com.br/tutoriais/fluxos/etiquetas/).

## Endpoints

- [Listar etiquetas](https://docs.nextags.com.br/referencia/etiquetas/listar-etiquetas.md): `GET /accounts/tags`
- [Criar etiqueta](https://docs.nextags.com.br/referencia/etiquetas/criar-etiqueta.md): `POST /accounts/tags`
- [Consultar etiqueta](https://docs.nextags.com.br/referencia/etiquetas/consultar-etiqueta.md): `GET /accounts/tags/{tag_id}`
- [Apagar etiqueta](https://docs.nextags.com.br/referencia/etiquetas/apagar-etiqueta.md): `DELETE /accounts/tags/{tag_id}`
- [Buscar etiqueta pelo nome](https://docs.nextags.com.br/referencia/etiquetas/buscar-etiqueta-pelo-nome.md): `GET /accounts/tags/name/{tag_name}`
- [Listar etiquetas do contato](https://docs.nextags.com.br/referencia/etiquetas/listar-etiquetas-do-contato.md): `GET /contacts/{contact_id}/tags`
- [Adicionar etiqueta ao contato](https://docs.nextags.com.br/referencia/etiquetas/adicionar-etiqueta-ao-contato.md): `POST /contacts/{contact_id}/tags/{tag_id}`
- [Remover etiqueta do contato](https://docs.nextags.com.br/referencia/etiquetas/remover-etiqueta-do-contato.md): `DELETE /contacts/{contact_id}/tags/{tag_id}`

## O objeto: Etiqueta

| Campo | Tipo | Descrição |
|---|---|---|
| `id` | integer | O ID da etiqueta. |
| `name` | string | O nome da etiqueta. |

```json
{
  "id": 2001,
  "name": "cliente-vip"
}
```