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
| Operacion | Scope |
|---|---|
| Listar / leer | suppressions:read |
| Anadir | suppressions:write |
| Eliminar | suppressions:write |
Scope faltante devuelve 403 con Missing required API key scope.
Endpoints
| Metodo | Endpoint | Descripcion |
|---|---|---|
GET | /suppressions | Listar direcciones suprimidas (paginado) |
POST | /suppressions | Anadir direccion manualmente |
DELETE | /suppressions/:email | Quitar 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.