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

# Cancelar suscripción con un clic (RFC 8058)

> Encabezados de lista de cancelación de suscripción para el botón nativo de cancelación de suscripción en Gmail y Yahoo.

**RFC 8058** es el botón "salir" de la bandeja de entrada, no es necesario abrir el correo electrónico y buscar el pie de página.

## ¿Por qué usarlo?

Gmail y Yahoo requieren cancelar la suscripción con un solo clic para recibir correo promocional. Sin los encabezados correctos, la exclusión voluntaria depende únicamente del enlace HTML (centro de preferencias). Con RFC 8058, el buzón muestra un botón nativo y Notifique acepta la solicitud de inmediato.

## Cuándo usarlo

* Plantilla **MARKETING** (y campañas/automatizaciones que la utilizan) → encabezados RFC 8058 **por defecto**
* **`POST /v1/email/messages`** cuando el destinatario se asigna a un contacto → **de forma predeterminada**
* Correo electrónico **transaccional** (recibo, OTP, restablecimiento de contraseña) → configurar `listUnsubscribe: false`
* El destinatario **no tiene contacto** en el espacio de trabajo → los encabezados no se inyectan (sin token)

## Cómo funciona

1. Al enviar, Notifique emite un token (la misma familia que `{{preferences_link}}`) y establece encabezados MIME:
   * `List-Unsubscribe: <https://…/w/list-unsubscribe/:contactId?token=…>`
   * `List-Unsubscribe-Post: List-Unsubscribe=One-Click`
2. Gmail/Yahoo **PUBLICAR** en esa URL con cuerpo `List-Unsubscribe=One-Click` (sin cookies, sin inicio de sesión), la opción de no participar ocurre **solo en la POST**.
3. Un **GET** en la misma URL solo valida el token y muestra una página de confirmación (sin cambio de preferencia, evita escáneres/búsqueda previa).
4. En POST, Notifique se da de baja **inmediatamente**:
   * con `topic` en la URL (plantilla con un tema) → tema `UNSUBSCRIBED` (tema no válido → error, sin respaldo global)
   * sin tema → `receiveMarketing = false`
5. La página de éxito puede vincularse al centro de preferencias para volver a suscribirse.

<Info>
  El pie de página con `{{preferences_link}}` / “haga clic aquí para cancelar la suscripción” todavía existe. RFC 8058 es **aditivo** (encabezados); no reemplaza el centro de preferencias.
</Info>

## API directa (`POST /v1/email/messages`)

| Field                    | Default | Effect                                                                               |
| ------------------------ | ------- | ------------------------------------------------------------------------------------ |
| `listUnsubscribe`        | `true`  | Injects headers when the recipient is a **contact** in the workspace                 |
| `listUnsubscribeTopicId` | ,       | Scopes one-click to a [topic](/es/contacts-api/como-funciona/topicos-de-comunicacao) |

If `listUnsubscribeTopicId` does not exist in this workspace: **400** with `code` **`INVALID_LIST_UNSUBSCRIBE_TOPIC`**. See [Error responses](/es/guides/conceitos/resposta-de-erros).

For transactional mail:

## Próximos pasos

* [Temas de comunicación](/es/contacts-api/como-funciona/topicos-de-comunicacao)
* [Inicio rápido de correo electrónico](/es/emails-api/como-funciona/quick-start)
* [Variables de plantilla](/es/template-api/como-funciona/variaveis-disponiveis-e-crud)