> ## 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.

# Scopes — Topics

> API Key permissions for marketing themes and consent (`topics:*`).

<Tip>
  Topics use **`topics:*`**. Subscribing a contact to a topic can be done via the dashboard, preferences link, or contact update.
</Tip>

## Scopes

| Scope               | Allows                                       |
| ------------------- | -------------------------------------------- |
| **`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}`                |

## Common combinations

| Flow                            | Scopes                                                            |
| ------------------------------- | ----------------------------------------------------------------- |
| Query topics only               | `topics:read`                                                     |
| Build CRM + marketing campaigns | `topics:read`, `topics:create`, `segments:read`, `campaigns:read` |
| Full topic management           | `topics:*`                                                        |

## Common errors

| Code                     | Cause                                   |
| ------------------------ | --------------------------------------- |
| **403**                  | Missing `topics:read` / `topics:create` |
| **403** `PLAN_LIMIT_CRM` | Topic limit for the plan                |
| **409**                  | Duplicate slug in the workspace         |

## Next steps

* [Quick Start — Topics](/en/contacts-api/como-funciona/topicos-quick-start)
* [Communication topics](/en/contacts-api/como-funciona/topicos-de-comunicacao)
* [General scopes](/en/contacts-api/como-funciona/escopos-da-api-key)