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

> API Key permissions for dynamic audiences (`segments:*`).

<Tip>
  Segments use **`segments:*`**. Reading contacts within a segment requires **`contacts:read`** (members route).
</Tip>

## Scopes

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

## Common combinations

| Flow                           | Scopes                                              |
| ------------------------------ | --------------------------------------------------- |
| Audience dashboard             | `segments:read`, `contacts:read`                    |
| CRM creates segments + exports | `segments:read`, `segments:create`, `contacts:read` |
| Full management                | `segments:*`                                        |

## Common errors

| Code                     | Cause                                                   |
| ------------------------ | ------------------------------------------------------- |
| **403**                  | Missing `segments:read` or `segments:create`            |
| **400**                  | Invalid `definition` (rule missing `tagId` / `topicId`) |
| **403** `PLAN_LIMIT_CRM` | Segment limit for the plan                              |

## Next steps

* [Quick Start — Segments](/en/contacts-api/como-funciona/segmentos-quick-start)
* [Segments in the Audience](/en/contacts-api/como-funciona/segmentos-na-audiencia)