Segment-Events

Kontakte, die einem Segment mit Tracking beitreten oder es verlassen.

segment.contact_added
segment.contact_removed

segment.contact_added

Wird gesendet, wenn ein Kontakt beginnt, einem Segment mit Tracking zu entsprechen. Segmente ohne Tracking senden dieses Event nicht. Auch die erste Zählung nach dem Erstellen eines Segments mit Tracking oder nach dem Fortsetzen des Trackings sendet es nicht.

Derselbe Beitritt startet Automatisierungen mit dem Trigger Added to segment und erreicht Ziele und Schritte Wait until zu diesem Event, sofern reason nicht segment_updated ist.

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 segment.contact_added.

objectobject

Die Änderung der Mitgliedschaft, 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.

Objekt der Segmentmitgliedschaft

objectstring

Immer segment_membership.

segmentobject

id und name des Segments.

contactobject

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

reasonstring

Warum der Kontakt beigetreten ist: contact, wenn sich Kontakte geändert haben, auch durch Importe und gelöschte Kontaktlisten, schedule, wenn die tägliche Synchronisierung den Beitritt festgestellt hat, zum Beispiel weil eine Datumsregel jetzt zutrifft, oder segment_updated, wenn Quelle oder Filter des Segments bearbeitet wurden.

joined_atstring

Zeitpunkt, zu dem Emailit den Beitritt erfasst hat, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "segment.contact_added",
  "object": {
    "object": "segment_membership",
    "segment": {
      "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
      "name": "Pro customers renewing soon"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "plan": "pro"
      }
    },
    "reason": "contact",
    "joined_at": "2026-10-18T12:00:00.000000+00:00"
  },
  "data": {
    "object": {
      "object": "segment_membership",
      "segment": {
        "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
        "name": "Pro customers renewing soon"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "plan": "pro"
        }
      },
      "reason": "contact",
      "joined_at": "2026-10-18T12:00:00.000000+00:00"
    }
  }
}

segment.contact_removed

Wird gesendet, wenn ein Kontakt aufhört, einem Segment mit Tracking zu entsprechen. Segmente ohne Tracking senden dieses Event nicht, und Kontakte, die das Segment verlassen, weil sie gelöscht wurden, ebenfalls nicht.

Derselbe Austritt startet Automatisierungen mit dem Trigger Removed from segment und beendet Durchläufe mit dieser Ausstiegsbedingung, sofern reason nicht segment_updated ist.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer segment.contact_removed.

objectobject

Die Änderung der Mitgliedschaft, 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.

Objekt der Segmentmitgliedschaft

objectstring

Immer segment_membership.

segmentobject

id und name des Segments.

contactobject

Der Kontakt in seinem aktuellen Zustand: id, email, first_name, last_name und custom_fields.

reasonstring

Warum der Kontakt das Segment verlassen hat: contact, wenn sich Kontakte geändert haben, auch durch Importe und gelöschte Kontaktlisten, schedule, wenn die tägliche Synchronisierung den Austritt festgestellt hat, zum Beispiel weil eine Datumsregel nicht mehr zutrifft, oder segment_updated, wenn Quelle oder Filter des Segments bearbeitet wurden.

left_atstring

Zeitpunkt, zu dem Emailit den Austritt erfasst hat, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLd4Ks8Vp1Rm6Wc3Nt9Bh5Qy0e",
  "type": "segment.contact_removed",
  "object": {
    "object": "segment_membership",
    "segment": {
      "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
      "name": "Pro customers renewing soon"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "plan": "pro",
        "renews_on": "2026-12-01"
      }
    },
    "reason": "schedule",
    "left_at": "2026-10-18T00:30:05.000000+00:00"
  },
  "data": {
    "object": {
      "object": "segment_membership",
      "segment": {
        "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
        "name": "Pro customers renewing soon"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "plan": "pro",
          "renews_on": "2026-12-01"
        }
      },
      "reason": "schedule",
      "left_at": "2026-10-18T00:30:05.000000+00:00"
    }
  }
}