Eventi delle soppressioni
Soppressioni create, aggiornate o eliminate.
suppression.created
Inviato quando viene aggiunta una soppressione con Crea una soppressione, con un’importazione CSV nel pannello o con il passaggio Add to suppressions di un’automazione. Le soppressioni che Emailit aggiunge automaticamente dopo bounce e segnalazioni non generano questo evento; ascolta invece email.bounced e email.complained.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre suppression.created.
objectobjectLa soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto soppressione
idstringID della soppressione (sup_…).
objectstringSempre suppression.
emailstringIndirizzo soppresso, in minuscolo.
typestringrecipient, bounce, complaint o unsubscribe. Solo le soppressioni recipient bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.
reasonstring | nullMotivo della soppressione.
created_atstringQuando è stata creata la soppressione, in formato ISO 8601 con offset UTC.
keep_untilstring | nullQuando scade la soppressione, oppure null se è 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
Inviato quando una soppressione viene modificata con Aggiorna una soppressione.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre suppression.updated.
objectobjectLa soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto soppressione
idstringID della soppressione (sup_…).
objectstringSempre suppression.
emailstringIndirizzo soppresso, in minuscolo.
typestringrecipient, bounce, complaint o unsubscribe. Solo le soppressioni recipient bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.
reasonstring | nullMotivo della soppressione.
created_atstringQuando è stata creata la soppressione, in formato ISO 8601 con offset UTC.
keep_untilstring | nullQuando scade la soppressione, oppure null se è 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
Inviato quando viene eliminata una soppressione con Elimina una soppressione. Una soppressione scaduta resta nella lista e non genera questo evento, e non lo genera nemmeno il passaggio Remove from suppressions di un’automazione.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre suppression.deleted.
objectobjectLa soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto soppressione
idstringID della soppressione (sup_…).
objectstringSempre suppression.
emailstringIndirizzo soppresso, in minuscolo.
typestringrecipient, bounce, complaint o unsubscribe. Solo le soppressioni recipient bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.
reasonstring | nullMotivo della soppressione.
created_atstringQuando è stata creata la soppressione, in formato ISO 8601 con offset UTC.
keep_untilstring | nullQuando scade la soppressione, oppure null se è 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
}
}
}