> ## 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 — Campanhas

> Permissões da API Key para criar e monitorar campanhas (`campaigns:*`).

<Tip>
  Campanhas usam **`campaigns:*`**. Criar campanha exige audiência e conteúdo — escopos de **segmentos**, **templates** e **mensagens** no fluxo completo.
</Tip>

## Escopos

| Escopo                 | Permite                                       |
| ---------------------- | --------------------------------------------- |
| **`campaigns:read`**   | `GET /v1/campaigns`, `GET /v1/campaigns/{id}` |
| **`campaigns:create`** | `POST /v1/campaigns`                          |
| **`campaigns:update`** | `PATCH /v1/campaigns/{id}`, cancelar          |
| **`campaigns:delete`** | `DELETE /v1/campaigns/{id}`                   |
| **`campaigns:run`**    | `POST /v1/campaigns/{id}/run`, preview de run |

## Combinações comuns

| Fluxo                       | Escopos                                                                |
| --------------------------- | ---------------------------------------------------------------------- |
| Só monitorar campanhas      | `campaigns:read`                                                       |
| Automação dispara campanhas | `campaigns:read`, `campaigns:create`, `campaigns:run`, `segments:read` |
| Gestão completa             | `campaigns:*`                                                          |

Escopos relacionados no mesmo integrador:

* **`segments:read`** — validar audiência
* **`templates:read`** — escolher template
* **`messages:send`** — se o disparo passa pela API de mensagens em vez de campanha

## Erros comuns

| Código               | Causa                                           |
| -------------------- | ----------------------------------------------- |
| **403**              | Sem `campaigns:create`                          |
| **400**              | Segmento vazio, template incompatível com canal |
| **403** `PLAN_LIMIT` | Limite de campanhas ou envios do plano          |

## Próximos passos

* [Quick Start — Campanhas](/contacts-api/como-funciona/campanhas-quick-start)
* [Campanhas no painel](/contacts-api/como-funciona/campanhas-no-painel)
* [Escopos gerais](/contacts-api/como-funciona/escopos-da-api-key)