Supresiones

La lista de supresiones es el mecanismo que protege tu reputación de envío. Toda dirección que genera un bounce permanente, una queja de spam o se da de baja queda en la lista automáticamente, y la plataforma omite ese email en todos los envíos futuros — tanto transaccional como bulk — sin que tengas que hacer nada.

---

Cómo se agregan entradas

Las supresiones se crean de tres formas:

Origen	reason	Descripción
Bounce permanente (5xx)	bounce	El servidor receptor rechazó definitivamente la dirección
Queja FBL / spam	complaint	El destinatario marcó el correo como spam
Desuscripción	unsubscribed	El contacto hizo clic en el enlace de baja o llamó al endpoint de baja
Manual	manual	Un admin agregó la dirección manualmente vía API o dashboard

---

Operaciones

• GET /v1/suppressions — listar todas las direcciones suprimidas, paginado. Query params: limit (default 100, max 1000), offset, reason (bounce|complaint|manual), email (búsqueda parcial).
• POST /v1/suppressions — agregar manualmente una dirección (requiere admin key). Body: { email: string, reason?: "manual"|"complaint" }. Útil para incorporar listas de opt-out propias.
• DELETE /v1/suppressions/{email} — “eliminar” una supresión para que la dirección pueda volver a recibir correos (requiere admin key). Returns 204.

Precaución

La eliminación de una supresión no borra el historial — agrega una entrada con reason: 'removed'. Esto mantiene un paper trail completo por razones de auditoría y cumplimiento. Si el mismo email genera otro bounce o queja después de ser removido, vuelve a suprimirse automáticamente.

---

Ejemplo: listar supresiones recientes

# Listar las últimas 20 supresiones por bounce
curl "https://api.mailerdash.com/v1/suppressions?reason=bounce&limit=20" \
  -H "Authorization: Bearer $MAILERDASH_API_KEY"

Respuesta:

{
  "total": 47,
  "limit": 20,
  "offset": 0,
  "items": [
    {
      "email": "usuario@dominio.com",
      "reason": "bounce",
      "code": "5.1.1",
      "added_at": "2026-06-15T10:30:00.000Z"
    }
  ]
}

Ejemplo: agregar una supresión manual

curl -X POST https://api.mailerdash.com/v1/suppressions \
  -H "Authorization: Bearer $MAILERDASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "optout@cliente.com", "reason": "manual"}'

Ejemplo: remover una supresión

curl -X DELETE "https://api.mailerdash.com/v1/suppressions/usuario%40dominio.com" \
  -H "Authorization: Bearer $MAILERDASH_API_KEY"

Consejo

El email en la ruta debe estar URL-encoded. El @ se escribe como %40. Por ejemplo: usuario@dominio.com → usuario%40dominio.com.

---

Consideraciones GDPR / privacidad

Si un usuario ejerce su derecho de eliminación de datos (derecho al olvido), el proceso correcto en MailerDash es:

1. Eliminar el contacto vía DELETE /v1/bulk/contacts/{email} — esto lo remueve de tus listas.
2. No remover la supresión — mantenerla protege al usuario de recibir futuros correos accidentales.

La cuenta del usuario en la plataforma (si existe) se anonimiza (email/nombre reemplazados por placeholders) al eliminarse, pero las supresiones permanecen como protección, no como dato personal identificable.

---

Referencia API: Plataforma — Supresiones

Migrar tu lista desde otro proveedor

Si vienes de otro ESP, sube su lista de supresión antes de tu primera campaña. No es un trámite: esa lista contiene direcciones que ya rebotaron o que ya te marcaron como spam allá. Sin importarla, tu primer envío con nosotros les vuelve a escribir a todas y cosecha los mismos rebotes y las mismas quejas — con el costo de reputación que eso trae, para ti y para el resto de la plataforma.

Se hace desde Entregabilidad → Supresiones → Importar CSV, subiendo el archivo o pegando las direcciones. El parser acepta los encabezados más comunes (email, address, correo) y también un archivo de una sola columna sin encabezado.

Elige bien el tipo de lista

Es la única decisión del formulario y tiene consecuencias distintas:

Tipo	Qué bloquea
Bajas de marketing (por defecto)	Sólo campañas y secuencias. Siguen recibiendo tu correo transaccional — recibos, restablecer contraseña.
Rebotes · Quejas de spam · Bloqueo manual	Todo el correo, incluido el transaccional.

El default es el menos destructivo a propósito. Un export de otro proveedor es sobre todo bajas de marketing, e importarlas como bloqueo total dejaría a esas personas sin poder restablecer su contraseña — encerradas fuera de su cuenta por haber dicho que no querían promociones.

Si tu archivo trae una columna reason con uno de esos valores, se respeta fila por fila y el tipo elegido sólo aplica al resto.

Reimportar es seguro

Las direcciones que ya están suprimidas se saltan; no se duplican ni se cuentan dos veces. La respuesta te dice cuántas entraron, cuántas ya estaban y cuáles no eran direcciones válidas.

Exportar

El botón Exportar descarga tu lista completa en CSV con email, reason y added_at — las mismas columnas que acepta el import, así que el archivo que sale vuelve a entrar. Sirve de respaldo y para peticiones de datos personales.