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_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 audience.created.
objectobjectDie Kontaktliste, 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.
Kontaktlisten-Objekt
idstringKontaktlisten-ID (aud_…).
objectstringImmer audience.
namestringName der Kontaktliste.
created_atstringZeitpunkt der Erstellung der Kontaktliste, im Format ISO 8601 mit UTC-Offset.
{
"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_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 audience.updated.
objectobjectDie Kontaktliste, 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.
Kontaktlisten-Objekt
idstringKontaktlisten-ID (aud_…).
objectstringImmer audience.
namestringName der Kontaktliste.
updated_atstringZeitpunkt der letzten Aktualisierung der Kontaktliste, im Format ISO 8601 mit UTC-Offset.
created_atstringZeitpunkt der Erstellung der Kontaktliste.
{
"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_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 audience.deleted.
objectobjectDie Kontaktliste, 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.
Kontaktlisten-Objekt
idstringKontaktlisten-ID (aud_…).
objectstringImmer audience.
namestringName der Kontaktliste.
updated_atstringZeitpunkt der letzten Aktualisierung der Kontaktliste, im Format ISO 8601 mit UTC-Offset.
created_atstringZeitpunkt der Erstellung der Kontaktliste.
{
"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"
}
}
}