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