> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Escopos — Tags

> Permissões da API Key para criar e gerenciar etiquetas (`tags:*`).

<Tip>
  Tags usam só a família **`tags:*`**. Aplicar tag na ficha do contato exige também **`contacts:update`**.
</Tip>

## Escopos

| Escopo            | Permite                             |
| ----------------- | ----------------------------------- |
| **`tags:read`**   | `GET /v1/tags`, `GET /v1/tags/{id}` |
| **`tags:create`** | `POST /v1/tags`                     |
| **`tags:update`** | `PUT /v1/tags/{id}`                 |
| **`tags:delete`** | `DELETE /v1/tags/{id}`              |

Associar tag a contato: `tagIds` em `POST/PUT /v1/contacts` — escopos **`contacts:create`** / **`contacts:update`**.

## Combinações comuns

| Fluxo                          | Escopos                                                        |
| ------------------------------ | -------------------------------------------------------------- |
| Só listar etiquetas            | `tags:read`                                                    |
| CRM sincroniza tags + contatos | `tags:read`, `tags:create`, `contacts:read`, `contacts:update` |
| Gestão completa de tags        | `tags:read`, `tags:create`, `tags:update`, `tags:delete`       |

## Erros comuns

| Código  | Causa                                       |
| ------- | ------------------------------------------- |
| **403** | Falta `tags:read` ou `tags:create` na chave |
| **409** | Nome de tag duplicado no workspace          |

Guia geral de chaves: [Escopos da API Key](/contacts-api/como-funciona/escopos-da-api-key).

## Próximos passos

* [Quick Start — Tags](/contacts-api/como-funciona/tags-quick-start)
* [Tags na audiência](/contacts-api/como-funciona/tags-na-audiencia)