Zum Inhalt springen
Doku

Kontaktlisten-Events

Erstellte, aktualisierte oder gelöschte Kontaktlisten.

audience.created

Wird gesendet, wenn eine Kontaktliste erstellt wird, zum Beispiel mit Kontaktliste erstellen.

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 audience.created.

objectobject

Die Kontaktliste, 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.

Kontaktlisten-Objekt

idstring

Kontaktlisten-ID (aud_…).

objectstring

Immer audience.

namestring

Name der Kontaktliste.

created_atstring

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

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.created",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Newsletter",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Newsletter",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

audience.updated

Wird gesendet, wenn sich eine Kontaktliste ändert, zum Beispiel wenn Sie sie mit Kontaktliste aktualisieren umbenennen. Änderungen an Abonnenten lösen stattdessen Abonnenten-Events aus.

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 audience.updated.

objectobject

Die Kontaktliste, 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.

Kontaktlisten-Objekt

idstring

Kontaktlisten-ID (aud_…).

objectstring

Immer audience.

namestring

Name der Kontaktliste.

updated_atstring

Zeitpunkt der letzten Aktualisierung der Kontaktliste, im Format ISO 8601 mit UTC-Offset.

created_atstring

Zeitpunkt der Erstellung der Kontaktliste.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.updated",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Monthly newsletter",
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-15T12:00:41.305000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Monthly newsletter",
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-15T12:00:41.305000+00:00"
    }
  }
}

audience.deleted

Wird gesendet, wenn eine Kontaktliste gelöscht wird, zum Beispiel mit Kontaktliste löschen. Der Payload ist die Kontaktliste im Zustand vor dem Löschen.

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 audience.deleted.

objectobject

Die Kontaktliste, 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.

Kontaktlisten-Objekt

idstring

Kontaktlisten-ID (aud_…).

objectstring

Immer audience.

namestring

Name der Kontaktliste.

updated_atstring

Zeitpunkt der letzten Aktualisierung der Kontaktliste, im Format ISO 8601 mit UTC-Offset.

created_atstring

Zeitpunkt der Erstellung der Kontaktliste.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.deleted",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Monthly newsletter",
    "updated_at": "2026-09-30T08:14:02.771000+00:00",
    "created_at": "2026-09-15T12:00:41.305000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Monthly newsletter",
      "updated_at": "2026-09-30T08:14:02.771000+00:00",
      "created_at": "2026-09-15T12:00:41.305000+00:00"
    }
  }
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.