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

> Permisos de la API Key para crear y gestionar etiquetas (`tags:*`).

<Tip>
  Las etiquetas usan solo la familia **`tags:*`**. Aplicar etiqueta en la ficha del contacto también exige **`contacts:update`**.
</Tip>

## Alcances

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

Asociar etiqueta a contacto: `tagIds` en `POST/PUT /v1/contacts` — alcances **`contacts:create`** / **`contacts:update`**.

## Combinaciones comunes

| Flujo                                | Alcances                                                       |
| ------------------------------------ | -------------------------------------------------------------- |
| Solo listar etiquetas                | `tags:read`                                                    |
| CRM sincroniza etiquetas + contactos | `tags:read`, `tags:create`, `contacts:read`, `contacts:update` |
| Gestión completa de etiquetas        | `tags:read`, `tags:create`, `tags:update`, `tags:delete`       |

## Errores comunes

| Código  | Causa                                                 |
| ------- | ----------------------------------------------------- |
| **403** | Falta `tags:read` o `tags:create` en la clave         |
| **409** | Nombre de etiqueta duplicado en el espacio de trabajo |

Guía general de claves: [Alcances de la API Key](/es/contacts-api/como-funciona/escopos-da-api-key).

## Próximos pasos

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