---
title: Temas
description: "Categorías de suscripción: los destinatarios se excluyen de un tipo de correo y siguen suscritos al resto. Un tema se puede ligar a un dominio de envío."
seo:
  title: Temas de email
ai:
  exclude: true
---

Un tema es una categoría de correo, como «Novedades del producto», «Boletín» o «Promociones». Los destinatarios pueden salirse de un tema y seguir suscritos al resto. Gestiona los temas en el panel, en **Contactos → Temas**, o con la API.

Cada tema tiene un `default_subscription`, que se define al crearlo y no se puede cambiar después:

- `opt_in`: todos los contactos están suscritos salvo que se excluyan.
- `opt_out`: un contacto está suscrito solo después de aceptarlo.

Un tema también tiene una `visibility`. Un tema `public` aparece en la página de baja, y uno `private` solo aparece a través de su propio enlace.

## Cómo se aplican los temas

- **Envíos masivos.** Un envío masivo puede dirigirse a un tema. Llega a los contactos suscritos a ese tema (por decisión propia o por el valor por defecto del tema). Los contactos dados de baja en todo el equipo, o que se dieron de baja del dominio de envío, siempre quedan fuera.
- **Emails individuales.** Envía un email con un `topic_id` y respeta ese tema. Si todas las direcciones de `to` se han excluido, el envío devuelve `422 all_recipients_suppressed`.
- **Página de baja.** La página lista los temas públicos, así que un destinatario puede desactivar uno o dejar de recibir todo el correo de marketing de ese dominio. El correo enviado sin `topic_id` y fuera de un envío masivo nunca se ve afectado. Consulta [Bajas](/docs/es/concepts/unsubscribes).

Un tema que usa un envío masivo, o que usó un email que aún espera a enviarse, no se puede eliminar: la llamada devuelve `409 conflict` hasta que esos envíos hayan salido o se hayan cancelado.

```sh
curl -X POST "https://api.billionsend.com/topics" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product updates", "default_subscription": "opt_in" }'
```

Defines las opciones de un contacto con `PATCH /contacts/{id}/topics`, pasando entradas como `{ "id": "<topic-id>", "subscription": "opt_in" }`. `GET /contacts/{id}/topics` lista todos los temas con la `subscription` del contacto y una marca `explicit` (falsa cuando es el valor por defecto del tema).

## Un tema por marca

Si cada uno de tus dominios es una marca distinta, liga un tema al dominio al que pertenece definiendo `domain_id`, al crearlo o después con `PATCH /topics/{id}`, o eligiendo el dominio en el panel.

- Un tema ligado aparece solo en la página de baja de ese dominio. La página de ningún otro dominio muestra su nombre.
- Un envío con ese `topic_id` debe salir de ese dominio. Desde cualquier otro, `POST /emails` y las llamadas de envíos masivos devuelven `422`.
- Un tema sin dominio aparece en la página de todos los dominios y se puede enviar desde cualquier dominio. `"domain_id": null` vuelve a hacer de un tema ligado un tema de todo el equipo.
- Un dominio no se puede eliminar mientras haya temas ligados a él (`409`).

Los [segmentos](/docs/es/concepts/segments) se pueden ligar de la misma manera.

## Claves de API limitadas a un dominio

Una clave de API limitada a un dominio solo puede crear temas ligados a ese dominio, y no puede crear uno de todo el equipo.
