Eventos de direcciones bloqueadas
Bloqueos creados, actualizados o eliminados.
suppression.created
Se envía cuando se añade un bloqueo con Crear un bloqueo, una importación CSV en el panel o el paso Add to suppressions de una automatización. Los bloqueos que Emailit añade automáticamente tras rebotes y quejas no envían este evento; escucha email.bounced y email.complained en su lugar.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre suppression.created.
objectobjectEl bloqueo que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de bloqueo
idstringEl ID del bloqueo (sup_…).
objectstringSiempre suppression.
emailstringLa dirección bloqueada, en minúsculas.
typestringrecipient, bounce, complaint o unsubscribe. Solo los bloqueos de tipo recipient detienen los envíos por API y SMTP; las campañas omiten las direcciones bloqueadas de cualquier tipo.
reasonstring | nullEl motivo del bloqueo.
created_atstringCuándo se creó el bloqueo, en formato ISO 8601 con desfase respecto a UTC.
keep_untilstring | nullCuándo caduca el bloqueo, o null si es permanente.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "suppression.created",
"object": {
"id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
"object": "suppression",
"email": "ada@example.com",
"type": "recipient",
"reason": "manual",
"created_at": "2026-10-01T09:30:12.481000+00:00",
"keep_until": null
},
"data": {
"object": {
"id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
"object": "suppression",
"email": "ada@example.com",
"type": "recipient",
"reason": "manual",
"created_at": "2026-10-01T09:30:12.481000+00:00",
"keep_until": null
}
}
}suppression.updated
Se envía cuando cambia un bloqueo con Actualizar un bloqueo.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre suppression.updated.
objectobjectEl bloqueo que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de bloqueo
idstringEl ID del bloqueo (sup_…).
objectstringSiempre suppression.
emailstringLa dirección bloqueada, en minúsculas.
typestringrecipient, bounce, complaint o unsubscribe. Solo los bloqueos de tipo recipient detienen los envíos por API y SMTP; las campañas omiten las direcciones bloqueadas de cualquier tipo.
reasonstring | nullEl motivo del bloqueo.
created_atstringCuándo se creó el bloqueo, en formato ISO 8601 con desfase respecto a UTC.
keep_untilstring | nullCuándo caduca el bloqueo, o null si es permanente.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "suppression.updated",
"object": {
"id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
"object": "suppression",
"email": "ada@example.com",
"type": "recipient",
"reason": "Asked to pause invoices until January",
"created_at": "2026-10-01T09:30:12.481000+00:00",
"keep_until": "2027-01-01T00:00:00.000000+00:00"
},
"data": {
"object": {
"id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
"object": "suppression",
"email": "ada@example.com",
"type": "recipient",
"reason": "Asked to pause invoices until January",
"created_at": "2026-10-01T09:30:12.481000+00:00",
"keep_until": "2027-01-01T00:00:00.000000+00:00"
}
}
}suppression.deleted
Se envía cuando se elimina un bloqueo con Eliminar un bloqueo. Un bloqueo caducado permanece en la lista y no envía este evento, y tampoco lo envía el paso Remove from suppressions de una automatización.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre suppression.deleted.
objectobjectEl bloqueo que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de bloqueo
idstringEl ID del bloqueo (sup_…).
objectstringSiempre suppression.
emailstringLa dirección bloqueada, en minúsculas.
typestringrecipient, bounce, complaint o unsubscribe. Solo los bloqueos de tipo recipient detienen los envíos por API y SMTP; las campañas omiten las direcciones bloqueadas de cualquier tipo.
reasonstring | nullEl motivo del bloqueo.
created_atstringCuándo se creó el bloqueo, en formato ISO 8601 con desfase respecto a UTC.
keep_untilstring | nullCuándo caduca el bloqueo, o null si es permanente.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "suppression.deleted",
"object": {
"id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
"object": "suppression",
"email": "ada@example.com",
"type": "recipient",
"reason": "manual",
"created_at": "2026-10-01T09:30:12.481000+00:00",
"keep_until": null
},
"data": {
"object": {
"id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
"object": "suppression",
"email": "ada@example.com",
"type": "recipient",
"reason": "manual",
"created_at": "2026-10-01T09:30:12.481000+00:00",
"keep_until": null
}
}
}