Zum Inhalt springen
Doku

Erstellte, aktualisierte oder gelöschte Kontakte.

contact.created

Wird gesendet, wenn ein Kontakt mit Kontakt erstellen erstellt wird. Wenn Sie audiences übergeben, sendet Emailit zusätzlich subscriber.created für jede Kontaktliste.

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

objectobject

Der Kontakt, 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.

Kontakt-Objekt

idstring

Kontakt-ID (con_…).

objectstring

Immer contact.

emailstring

Adresse des Kontakts, in Kleinbuchstaben.

first_namestring | null

Vorname.

last_namestring | null

Nachname.

custom_fieldsobject

Werte der eigenen Felder, mit dem Feld als Schlüssel. Siehe Eigene Felder.

unsubscribedboolean

Ob der Kontakt von allen Kampagnen abgemeldet ist.

created_atstring

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

audiencesobject[]

Kontaktlisten, zu denen der Kontakt gehört. Jedes Element enthält die id der Kontaktliste und ein Objekt subscriber mit id, subscribed, subscribed_at und unsubscribed_at.

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

contact.updated

Wird gesendet, wenn sich ein Kontakt ändert, mit Kontakt aktualisieren oder den Aktionen unsubscribe und resubscribe der Massenaktionen für Kontakte. Änderungen an Kontaktlisten lösen außerdem 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 contact.updated.

objectobject

Der Kontakt, 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.

Kontakt-Objekt

idstring

Kontakt-ID (con_…).

objectstring

Immer contact.

emailstring

Adresse des Kontakts, in Kleinbuchstaben.

first_namestring | null

Vorname.

last_namestring | null

Nachname.

custom_fieldsobject

Werte der eigenen Felder, mit dem Feld als Schlüssel. Siehe Eigene Felder.

unsubscribedboolean

Ob der Kontakt von allen Kampagnen abgemeldet ist.

updated_atstring

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

created_atstring

Zeitpunkt der Erstellung des Kontakts.

audiencesobject[]

Kontaktlisten, zu denen der Kontakt gehört. Jedes Element enthält die id der Kontaktliste und ein Objekt subscriber mit id, subscribed, subscribed_at und unsubscribed_at.

previousobject

Alte Werte der geänderten Felder unter email, first_name, last_name, unsubscribed und custom_fields. Fehlt, wenn sich keines davon geändert hat.

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

contact.deleted

Wird gesendet, wenn ein Kontakt mit Kontakt löschen oder der Massenaktion delete gelöscht wird. Vorher sendet Emailit subscriber.deleted für jede Kontaktliste, zu der der Kontakt gehörte.

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

objectobject

Der Kontakt, 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.

Kontakt-Objekt

idstring

Kontakt-ID (con_…).

objectstring

Immer contact.

emailstring

Adresse des Kontakts, in Kleinbuchstaben.

first_namestring | null

Vorname.

last_namestring | null

Nachname.

custom_fieldsobject

Werte der eigenen Felder, mit dem Feld als Schlüssel. Siehe Eigene Felder.

unsubscribedboolean

Ob der Kontakt von allen Kampagnen abgemeldet ist.

updated_atstring

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

created_atstring

Zeitpunkt der Erstellung des Kontakts.

audiencesobject[]

Kontaktlisten, zu denen der Kontakt gehört. Jedes Element enthält die id der Kontaktliste und ein Objekt subscriber mit id, subscribed, subscribed_at und unsubscribed_at.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "contact.deleted",
  "object": {
    "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
    "object": "contact",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines"
    },
    "unsubscribed": false,
    "updated_at": "2026-09-30T16:48:55.120000+00:00",
    "created_at": "2026-09-20T14:22:09.418000+00:00",
    "audiences": [
      {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "subscriber": {
          "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
          "subscribed": true,
          "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
          "unsubscribed_at": null
        }
      }
    ]
  },
  "data": {
    "object": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "object": "contact",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "unsubscribed": false,
      "updated_at": "2026-09-30T16:48:55.120000+00:00",
      "created_at": "2026-09-20T14:22:09.418000+00:00",
      "audiences": [
        {
          "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
          "subscriber": {
            "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
            "subscribed": true,
            "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
            "unsubscribed_at": null
          }
        }
      ]
    }
  }
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.