> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestionar bajas de suscripción

> Registra y aplica las bajas (opt-outs) de clientes por canal.

## Qué es

Un registro de baja de suscripción indica que un cliente optó por no recibir mensajes
de tu empresa en un canal específico. El cliente y el canal forman juntos
el registro único.

## Antes de empezar

* Define cómo recopila y registra el consentimiento tu producto.
* Normaliza los números de teléfono al formato E.164.
* Elige el tipo de identificador de cliente y el canal correctos.
* Decide cómo se sincronizan las bajas con tus sistemas de origen.

## Cómo funciona

1. Crea una baja de suscripción cuando un cliente opte por no recibir mensajes.
2. Comprueba o lista los registros antes del envío cuando tu flujo de trabajo no aplique ya
   la supresión de forma automática.
3. Elimina el registro solo cuando el cliente vuelva a suscribirse (opt-in) válidamente.
4. Procesa los eventos de Webhook de baja de suscripción para sincronizar los sistemas externos.

No interpretes la eliminación como una prueba automática de consentimiento. Tu aplicación debe
conservar la evidencia y la base de políticas para la resuscripción.

## Solicitud

### Crear una baja de suscripción

`POST /unsubscribers`

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST https://api.ycloud.com/v2/unsubscribers \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "type": "PHONE_NUMBER",
    "customer": "+16315551111",
    "channel": "whatsapp",
    "regionCode": "US"
  }'
```

### Eliminar una baja de suscripción tras el opt-in

`DELETE /unsubscribers/{customer}/{channel}`

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request DELETE \
  https://api.ycloud.com/v2/unsubscribers/+16315551111/whatsapp \
  --header "X-API-Key: $YCLOUD_API_KEY"
```

Codifica en URL (URL-encode) el valor de la ruta del cliente cuando lo requiera tu cliente HTTP.

## Respuesta

La creación devuelve el registro guardado.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "type": "PHONE_NUMBER",
  "customer": "+16315551111",
  "channel": "whatsapp",
  "regionCode": "US"
}
```

La obtención y la eliminación devuelven el recurso de baja coincidente. Un registro
no encontrado devuelve un error en lugar de un estado de baja.

## Cumplimiento

Trata la supresión como un límite de seguridad. Aplícala de forma coherente en envíos
masivos, flujos transaccionales donde la política lo requiera, reintentos y operaciones
manuales.

Utiliza eventos de Webhook para sincronizar nuevas bajas y registros de bajas eliminados.

## Límites y resolución de problemas

* El mismo cliente puede tener registros independientes para diferentes canales.
* Utiliza el `type` correcto para el identificador del cliente.
* No elimines silenciosamente un registro sin un evento de opt-in válido.
* Los endpoints de listado admiten paginación por cursor; sigue `cursor.after`.
* Diseña el procesamiento concurrente de opt-in y opt-out de modo que prevalezca la decisión
  válida más reciente del cliente.

<CardGroup cols={2}>
  <Card title="Crear una baja de suscripción" icon="user-slash" href="/api-reference/unsubscribers/create-an-unsubscriber">
    Inspecciona los tipos de identificadores y canales compatibles.
  </Card>

  <Card title="Webhooks de baja de suscripción" icon="webhook" href="/es/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples">
    Sincroniza eventos de opt-out y resuscripción.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.