Événements de segment

Contacts qui entrent dans un segment avec suivi ou en sortent.

segment.contact_added
segment.contact_removed

segment.contact_added

Envoyé lorsqu’un contact commence à correspondre à un segment avec suivi. Les segments sans suivi n’envoient pas cet événement. Le premier décompte après la création d’un segment avec suivi, ou après la reprise du suivi, ne l’envoie pas non plus.

La même entrée démarre les automatisations dotées du déclencheur Added to segment, et remplit les objectifs et fait reprendre les étapes Wait until qui portent sur cet événement, sauf si reason vaut segment_updated.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours segment.contact_added.

objectobject

Le changement d’appartenance décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet d’appartenance à un segment

objectstring

Toujours segment_membership.

segmentobject

id et name du segment.

contactobject

Le contact : id, email, first_name, last_name et custom_fields.

reasonstring

Pourquoi le contact est entré : contact lorsque des contacts ont changé, y compris par des imports et des listes supprimées, schedule lorsque la synchronisation quotidienne l’a détecté, par exemple parce qu’une règle de date correspond désormais, ou segment_updated lorsque la source ou les filtres du segment ont été modifiés.

joined_atstring

Date à laquelle Emailit a enregistré l’entrée, au format ISO 8601 avec décalage UTC.

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

Envoyé lorsqu’un contact cesse de correspondre à un segment avec suivi. Les segments sans suivi n’envoient pas cet événement, pas plus que les contacts qui sortent parce qu’ils ont été supprimés.

La même sortie démarre les automatisations dotées du déclencheur Removed from segment, et met fin aux exécutions qui ont cette condition de sortie, sauf si reason vaut segment_updated.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

typestring

Toujours segment.contact_removed.

objectobject

Le changement d’appartenance décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet d’appartenance à un segment

objectstring

Toujours segment_membership.

segmentobject

id et name du segment.

contactobject

Le contact tel qu’il est maintenant : id, email, first_name, last_name et custom_fields.

reasonstring

Pourquoi le contact est sorti : contact lorsque des contacts ont changé, y compris par des imports et des listes supprimées, schedule lorsque la synchronisation quotidienne l’a détecté, par exemple parce qu’une règle de date ne correspond plus, ou segment_updated lorsque la source ou les filtres du segment ont été modifiés.

left_atstring

Date à laquelle Emailit a enregistré la sortie, au format ISO 8601 avec décalage UTC.

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"
    }
  }
}