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

# Alcances — Segmentos

> Permisos de la API Key para audiencias dinámicas (`segments:*`).

<Tip>
  Los segmentos usan **`segments:*`**. Leer contactos dentro del segmento exige **`contacts:read`** (ruta de miembros).
</Tip>

## Alcances

| Alcance               | 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}`                                                   |

## Combinaciones comunes

| Flujo                        | Alcances                                            |
| ---------------------------- | --------------------------------------------------- |
| Dashboard de audiencia       | `segments:read`, `contacts:read`                    |
| CRM crea segmentos + exporta | `segments:read`, `segments:create`, `contacts:read` |
| Gestión completa             | `segments:*`                                        |

## Errores comunes

| Código                   | Causa                                                 |
| ------------------------ | ----------------------------------------------------- |
| **403**                  | Sin `segments:read` o `segments:create`               |
| **400**                  | `definition` inválida (regla sin `tagId` / `topicId`) |
| **403** `PLAN_LIMIT_CRM` | Límite de segmentos del plan                          |

## Próximos pasos

* [Inicio rápido — Segmentos](/es/contacts-api/como-funciona/segmentos-quick-start)
* [Segmentos en la audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia)