Zum Inhalt springen
Doku

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_idstring

Event-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.

typestring

Immer suppression.created.

objectobject

Die Sperrung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Sperrungs-Objekt

idstring

Sperrungs-ID (sup_…).

objectstring

Immer suppression.

emailstring

Gesperrte Adresse, in Kleinbuchstaben.

typestring

recipient, bounce, complaint oder unsubscribe. Nur Sperrungen vom Typ recipient stoppen Versände per API und SMTP; Kampagnen überspringen jeden Typ.

reasonstring | null

Grund für die Sperrung.

created_atstring

Zeitpunkt der Erstellung der Sperrung, im Format ISO 8601 mit UTC-Offset.

keep_untilstring | null

Zeitpunkt, zu dem die Sperrung abläuft, oder null, wenn sie dauerhaft ist.

JSON
{
  "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_idstring

Event-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.

typestring

Immer suppression.updated.

objectobject

Die Sperrung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Sperrungs-Objekt

idstring

Sperrungs-ID (sup_…).

objectstring

Immer suppression.

emailstring

Gesperrte Adresse, in Kleinbuchstaben.

typestring

recipient, bounce, complaint oder unsubscribe. Nur Sperrungen vom Typ recipient stoppen Versände per API und SMTP; Kampagnen überspringen jeden Typ.

reasonstring | null

Grund für die Sperrung.

created_atstring

Zeitpunkt der Erstellung der Sperrung, im Format ISO 8601 mit UTC-Offset.

keep_untilstring | null

Zeitpunkt, zu dem die Sperrung abläuft, oder null, wenn sie dauerhaft ist.

JSON
{
  "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_idstring

Event-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.

typestring

Immer suppression.deleted.

objectobject

Die Sperrung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Sperrungs-Objekt

idstring

Sperrungs-ID (sup_…).

objectstring

Immer suppression.

emailstring

Gesperrte Adresse, in Kleinbuchstaben.

typestring

recipient, bounce, complaint oder unsubscribe. Nur Sperrungen vom Typ recipient stoppen Versände per API und SMTP; Kampagnen überspringen jeden Typ.

reasonstring | null

Grund für die Sperrung.

created_atstring

Zeitpunkt der Erstellung der Sperrung, im Format ISO 8601 mit UTC-Offset.

keep_untilstring | null

Zeitpunkt, zu dem die Sperrung abläuft, oder null, wenn sie dauerhaft ist.

JSON
{
  "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
    }
  }
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.