Zum Inhalt springen
Doku

Abonnenten-Events

Kontakte, die einer Kontaktliste hinzugefügt, darin geändert, ihr erneut hinzugefügt oder aus ihr entfernt wurden.

subscriber.created

Wird gesendet, wenn ein Kontakt mit Abonnent hinzufügen zu einer Kontaktliste hinzugefügt wird oder wenn Sie einen Kontakt mit audiences erstellen oder aktualisieren. Fügen Sie einen Kontakt hinzu, der sich von der Kontaktliste abgemeldet hatte, werden stattdessen subscriber.updated und subscriber.resubscribed gesendet.

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

objectobject

Der Abonnent, den das Event beschreibt. Seine Felder sind unten aufgeführt.

data.objectobject

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

Abonnenten-Objekt

idstring

Abonnenten-ID (sub_…). Ein Abonnent ist die Mitgliedschaft eines Kontakts in einer Kontaktliste.

objectstring

Immer subscriber.

subscribedboolean

Ob der Kontakt bei der Kontaktliste angemeldet ist.

subscribed_atstring | null

Zeitpunkt der Anmeldung des Kontakts oder null.

unsubscribed_atstring | null

Zeitpunkt der Abmeldung des Kontakts oder null.

audienceobject

id und name der Kontaktliste.

contactobject

Der Kontakt: id, email, first_name, last_name und custom_fields.

created_atstring

Zeitpunkt, zu dem der Kontakt zur Kontaktliste hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.created",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "created_at": "2026-09-20T14:22:09.418302+00:00"
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "created_at": "2026-09-20T14:22:09.418302+00:00"
    }
  }
}

subscriber.updated

Wird gesendet, wenn sich ein Abonnent ändert: Sie aktualisieren ihn mit Abonnent aktualisieren, der Kontakt meldet sich ab oder erneut an, oder ein Kontakt, der sich abgemeldet hatte, wird wieder zur Kontaktliste hinzugefügt. Geht die Änderung auf eine Abmeldung oder erneute Anmeldung zurück, enthält previous die alten Werte.

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

objectobject

Der Abonnent, den das Event beschreibt. Seine Felder sind unten aufgeführt.

data.objectobject

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

Abonnenten-Objekt

idstring

Abonnenten-ID (sub_…). Ein Abonnent ist die Mitgliedschaft eines Kontakts in einer Kontaktliste.

objectstring

Immer subscriber.

subscribedboolean

Ob der Kontakt bei der Kontaktliste angemeldet ist.

subscribed_atstring | null

Zeitpunkt der Anmeldung des Kontakts oder null.

unsubscribed_atstring | null

Zeitpunkt der Abmeldung des Kontakts oder null.

audienceobject

id und name der Kontaktliste.

contactobject

Der Kontakt: id, email, first_name, last_name und custom_fields.

updated_atstring

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

created_atstring

Zeitpunkt, zu dem der Kontakt zur Kontaktliste hinzugefügt wurde.

previousobject

Alte Werte, vorhanden, wenn sich der Kontakt abgemeldet oder erneut angemeldet hat: subscribed und unsubscribed_at. Fehlt bei anderen Änderungen.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.updated",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": false,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00",
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00",
    "previous": {
      "subscribed": true,
      "unsubscribed_at": null
    }
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": false,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00",
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00",
      "previous": {
        "subscribed": true,
        "unsubscribed_at": null
      }
    }
  }
}

subscriber.resubscribed

Wird gesendet, wenn Sie einen Kontakt mit Abonnent hinzufügen zu einer Kontaktliste hinzufügen, von der er sich abgemeldet hatte. Emailit sendet außerdem subscriber.updated mit demselben Abonnenten.

subscriber.resubscribed steht nicht in der Event-Liste der Weboberfläche. Sie erhalten es auf Webhooks, bei denen all_events aktiviert ist, oder indem Sie es mit Webhook aktualisieren zu events hinzufügen.

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 subscriber.resubscribed.

objectobject

Der Abonnent, den das Event beschreibt. Seine Felder sind unten aufgeführt.

data.objectobject

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

Abonnenten-Objekt

idstring

Abonnenten-ID (sub_…). Ein Abonnent ist die Mitgliedschaft eines Kontakts in einer Kontaktliste.

objectstring

Immer subscriber.

subscribedboolean

Ob der Kontakt bei der Kontaktliste angemeldet ist.

subscribed_atstring | null

Zeitpunkt der Anmeldung des Kontakts oder null.

unsubscribed_atstring | null

Zeitpunkt der Abmeldung des Kontakts oder null.

audienceobject

id und name der Kontaktliste.

contactobject

Der Kontakt: id, email, first_name, last_name und custom_fields.

updated_atstring

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

created_atstring

Zeitpunkt, zu dem der Kontakt zur Kontaktliste hinzugefügt wurde.

resubscribedboolean

Immer true.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.resubscribed",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-10-01T10:02:14.307000+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00",
    "resubscribed": true
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-10-01T10:02:14.307000+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00",
      "resubscribed": true
    }
  }
}

subscriber.deleted

Wird gesendet, wenn ein Kontakt aus einer Kontaktliste entfernt wird: mit Abonnent löschen, wenn Sie die audiences eines Kontakts ändern oder wenn Sie den Kontakt löschen. Der Payload ist der Abonnent im Zustand vor dem Entfernen.

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

objectobject

Der Abonnent, den das Event beschreibt. Seine Felder sind unten aufgeführt.

data.objectobject

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

Abonnenten-Objekt

idstring

Abonnenten-ID (sub_…). Ein Abonnent ist die Mitgliedschaft eines Kontakts in einer Kontaktliste.

objectstring

Immer subscriber.

subscribedboolean

Ob der Kontakt bei der Kontaktliste angemeldet ist.

subscribed_atstring | null

Zeitpunkt der Anmeldung des Kontakts oder null.

unsubscribed_atstring | null

Zeitpunkt der Abmeldung des Kontakts oder null.

audienceobject

id und name der Kontaktliste.

contactobject

Der Kontakt: id, email, first_name, last_name und custom_fields.

updated_atstring

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

created_atstring

Zeitpunkt, zu dem der Kontakt zur Kontaktliste hinzugefügt wurde.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.deleted",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-09-20T14:22:09.418302+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00"
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-09-20T14:22:09.418302+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00"
    }
  }
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.

Esc

Beliebt

↑↓zum Navigieren↵zum ÖffnenEsczum Schließen