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

> Crea temas de marketing, vincúlalos a plantillas y filtra audiencias por consentimiento.

<Tip>
  Un **tema** = asunto que la persona acepta recibir (Newsletter, Promociones). Diferente de **etiqueta** (marca interna).
</Tip>

## En resumen

* **Crea** el tema con nombre y **slug** estable.
* **Vincula** a la plantilla de categoría MARKETING.
* **Filtra** segmentos con regla `type: topic`.

Contexto: [Temas de comunicación](/es/contacts-api/como-funciona/topicos-de-comunicacao). Alcances: [Alcances de temas](/es/contacts-api/como-funciona/topicos-escopos-da-api-key).

## Antes de empezar

| Ítem                | Obligatorio     |
| ------------------- | --------------- |
| **`topics:create`** | Para crear tema |
| **`topics:read`**   | Para listar     |

Auth: `Authorization: Bearer sk_live_...`. URL base: `https://api.notifique.dev`.

***

## 1. Por el panel

1. **Audiencia → Temas → Nuevo**
2. Nombre (`Newsletter`), **slug** (`newsletter`), descripción para el enlace de preferencias
3. Opt-in predeterminado para nuevos contactos (opcional)
4. En la **plantilla MARKETING**, asocia el tema correcto

***

## 2. Crear tema (API)

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

```json theme={null}
{
  "name": "Newsletter",
  "slug": "newsletter",
  "description": "Novedades y artículos de la empresa",
  "defaultOptIn": false
}
```

Respuesta **200** — guarda el `id` para segmentos y plantillas.

<Warning>
  Cuando las campañas dependen del slug, **evita renombrarlo**.
</Warning>

***

## 3. Listar temas

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

***

## 4. Segmento "suscrito al tema"

```json theme={null}
{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "topic", "topicId": "clxxTopicNews", "subscribed": true },
    { "type": "receiveMarketing", "value": true }
  ]
}
```

***

## 5. Enlace de preferencias en el correo

En la ficha del contacto, genera el enlace de preferencias. En la plantilla usa `{{preferences_link}}` — la persona elige en qué temas quiere recibir.

***

## Próximos pasos

* [Campañas](/es/contacts-api/como-funciona/campanhas-no-painel)
* [One-click unsubscribe](/es/emails-api/como-funciona/one-click-unsubscribe-rfc-8058)
* [Introducción](/es/contacts-api/como-funciona/introducao)