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

# Inicio rápido — Etiquetas

> Crea una etiqueta, aplícala en contactos y úsala en segmentos — panel o API.

<Tip>
  Una **etiqueta** es reutilizable (`Lead`, `VIP`). Créala una vez, úsala en varios contactos y en reglas de segmento.
</Tip>

## En resumen

* **Crea** la etiqueta en el panel o con `POST /v1/tags`.
* **Aplica** en la ficha del contacto con `tagIds` o en la importación.
* **Filtra** en segmentos con regla `type: tag`.

Contexto: [Etiquetas en la audiencia](/es/contacts-api/como-funciona/tags-na-audiencia). Alcances: [Alcances de etiquetas](/es/contacts-api/como-funciona/tags-escopos-da-api-key).

## Antes de empezar

| Ítem                          | Obligatorio                                |
| ----------------------------- | ------------------------------------------ |
| Alcance **`tags:create`**     | Para crear                                 |
| Alcance **`tags:read`**       | Para listar                                |
| Alcance **`contacts:update`** | Para asignar etiqueta a contacto existente |

Auth: `Authorization: Bearer sk_live_...` o `x-api-key`. URL base: `https://api.notifique.dev`.

***

## 1. Por el panel

1. **Audiencia → Etiquetas → Nueva**
2. Nombre corto (`Lead`, `Cliente`, `Black Friday`)
3. En la ficha del contacto o en la importación, marca las etiquetas deseadas

***

## 2. Crear etiqueta (API)

```http theme={null}
POST /v1/tags
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "VIP"
}
```

Respuesta **200** — guarda el `id` para usar en contactos y segmentos.

***

## 3. Listar etiquetas

```http theme={null}
GET /v1/tags?page=1&limit=50
Authorization: Bearer sk_live_xxxxx
```

***

## 4. Aplicar etiqueta en un contacto

Al **crear** o **editar** el contacto, envía `tagIds`:

```http theme={null}
PUT /v1/contacts/{id}
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "tagIds": ["clxxTagVip", "clxxTagLead"]
}
```

***

## 5. Usar en segmento

```json theme={null}
{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "tag", "tagId": "clxxTagVip" },
    { "type": "receiveMarketing", "value": true }
  ]
}
```

Detalles: [Segmentos — Inicio rápido](/es/contacts-api/como-funciona/segmentos-quick-start).

***

## Próximos pasos

* [Segmentos en la audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia)
* [Campañas](/es/contacts-api/como-funciona/campanhas-no-painel)
* [Introducción](/es/contacts-api/como-funciona/introducao)