> ## 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 — Tópicos

> Permissões da API Key para temas de marketing e consentimento (`topics:*`).

<Tip>
  Tópicos usam **`topics:*`**. Inscrição do contato em um tópico pode ser via painel, link de preferências ou atualização do contato.
</Tip>

## Escopos

| Escopo              | Permite                                      |
| ------------------- | -------------------------------------------- |
| **`topics:read`**   | `GET /v1/topics`, `GET /v1/topics/{topicId}` |
| **`topics:create`** | `POST /v1/topics`                            |
| **`topics:update`** | `PATCH /v1/topics/{topicId}`                 |
| **`topics:delete`** | `DELETE /v1/topics/{topicId}`                |

## Combinações comuns

| Fluxo                            | Escopos                                                           |
| -------------------------------- | ----------------------------------------------------------------- |
| Só consultar tópicos             | `topics:read`                                                     |
| Montar CRM + campanhas marketing | `topics:read`, `topics:create`, `segments:read`, `campaigns:read` |
| Gestão completa de tópicos       | `topics:*`                                                        |

## Erros comuns

| Código                   | Causa                               |
| ------------------------ | ----------------------------------- |
| **403**                  | Sem `topics:read` / `topics:create` |
| **403** `PLAN_LIMIT_CRM` | Limite de tópicos do plano          |
| **409**                  | Slug duplicado no workspace         |

## Próximos passos

* [Quick Start — Tópicos](/contacts-api/como-funciona/topicos-quick-start)
* [Tópicos de comunicação](/contacts-api/como-funciona/topicos-de-comunicacao)
* [Escopos gerais](/contacts-api/como-funciona/escopos-da-api-key)