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

> Permissões da API Key para audiências dinâmicas (`segments:*`).

<Tip>
  Segmentos usam **`segments:*`**. Ler contatos dentro do segmento exige **`contacts:read`** (rota de membros).
</Tip>

## Escopos

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

## Combinações comuns

| Fluxo                        | Escopos                                             |
| ---------------------------- | --------------------------------------------------- |
| Dashboard de audiência       | `segments:read`, `contacts:read`                    |
| CRM cria segmentos + exporta | `segments:read`, `segments:create`, `contacts:read` |
| Gestão completa              | `segments:*`                                        |

## Erros comuns

| Código                   | Causa                                                 |
| ------------------------ | ----------------------------------------------------- |
| **403**                  | Sem `segments:read` ou `segments:create`              |
| **400**                  | `definition` inválida (regra sem `tagId` / `topicId`) |
| **403** `PLAN_LIMIT_CRM` | Limite de segmentos do plano                          |

## Próximos passos

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