Sperrungs-Events
Erstellte, aktualisierte oder gelöschte Sperrungen.
suppression.created
Wird gesendet, wenn eine Sperrung mit Sperrung erstellen, per CSV-Import in der Weboberfläche oder über den Schritt Add to suppressions einer Automatisierung angelegt wird. Sperrungen, die Emailit nach Bounces und Beschwerden automatisch anlegt, lösen dieses Event nicht aus; abonnieren Sie stattdessen email.bounced und email.complained.
Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.
Felder
event_idstringEvent-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.
typestringImmer suppression.created.
objectobjectDie Sperrung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.
data.objectobjectNoch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.
Sperrungs-Objekt
idstringSperrungs-ID (sup_…).
objectstringImmer suppression.
emailstringGesperrte Adresse, in Kleinbuchstaben.
typestringrecipient, bounce, complaint oder unsubscribe. Nur Sperrungen vom Typ recipient stoppen Versände per API und SMTP; Kampagnen überspringen jeden Typ.
reasonstring | nullGrund für die Sperrung.
created_atstringZeitpunkt der Erstellung der Sperrung, im Format ISO 8601 mit UTC-Offset.
keep_untilstring | nullZeitpunkt, zu dem die Sperrung abläuft, oder null, wenn sie dauerhaft ist.
{
"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
Wird gesendet, wenn sich eine Sperrung durch Sperrung aktualisieren ändert.
Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.
Felder
event_idstringEvent-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.
typestringImmer suppression.updated.
objectobjectDie Sperrung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.
data.objectobjectNoch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.
Sperrungs-Objekt
idstringSperrungs-ID (sup_…).
objectstringImmer suppression.
emailstringGesperrte Adresse, in Kleinbuchstaben.
typestringrecipient, bounce, complaint oder unsubscribe. Nur Sperrungen vom Typ recipient stoppen Versände per API und SMTP; Kampagnen überspringen jeden Typ.
reasonstring | nullGrund für die Sperrung.
created_atstringZeitpunkt der Erstellung der Sperrung, im Format ISO 8601 mit UTC-Offset.
keep_untilstring | nullZeitpunkt, zu dem die Sperrung abläuft, oder null, wenn sie dauerhaft ist.
{
"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
Wird gesendet, wenn eine Sperrung mit Sperrung löschen gelöscht wird. Eine abgelaufene Sperrung bleibt in der Liste und löst dieses Event nicht aus, ebenso wenig der Schritt Remove from suppressions einer Automatisierung.
Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.
Felder
event_idstringEvent-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.
typestringImmer suppression.deleted.
objectobjectDie Sperrung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.
data.objectobjectNoch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.
Sperrungs-Objekt
idstringSperrungs-ID (sup_…).
objectstringImmer suppression.
emailstringGesperrte Adresse, in Kleinbuchstaben.
typestringrecipient, bounce, complaint oder unsubscribe. Nur Sperrungen vom Typ recipient stoppen Versände per API und SMTP; Kampagnen überspringen jeden Typ.
reasonstring | nullGrund für die Sperrung.
created_atstringZeitpunkt der Erstellung der Sperrung, im Format ISO 8601 mit UTC-Offset.
keep_untilstring | nullZeitpunkt, zu dem die Sperrung abläuft, oder null, wenn sie dauerhaft ist.
{
"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
}
}
}