DocumentacionLista de supresion

Lista de supresion

Bloquear envios a direcciones con rebote, queja o baja.

Una supresion es una direccion de email que no debe recibir mas mensajes. MailingCore bloquea envios a direcciones suprimidas al encolar — protege reputacion y respeta bajas GDPR.

Las supresiones se crean automaticamente por rebotes duros, quejas y flujos de baja. Tambien puedes gestionar la lista via API.

Scopes requeridos

OperacionScope
Listar / leersuppressions:read
Anadirsuppressions:write
Eliminarsuppressions:write

Scope faltante devuelve 403 con Missing required API key scope.

Endpoints

MetodoEndpointDescripcion
GET/suppressionsListar direcciones suprimidas (paginado)
POST/suppressionsAnadir direccion manualmente
DELETE/suppressions/:emailQuitar supresion (codifica el email en URL)

Listar

GET /suppressions?limit=50&cursor=...
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Anadir

POST /suppressions
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx
Content-Type: application/json

{
  "email": "[email protected]",
  "reason": "manual"
}

Valores habituales de reason: bounce, complaint, unsubscribe, manual.

Eliminar

DELETE /suppressions/usuario%40example.com
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Panel

Los contactos con suppressedAt aparecen suprimidos en Contactos. La lista se mantiene sincronizada con /suppressions.