# Événements de segment

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



## segment.contact_added

> Envoyé lorsqu’un contact entre dans un segment avec suivi, avec le segment, le contact, la raison et la date d’entrée. Alpha : réservé à l’équipe Emailit.

# segment.contact_added

Envoyé lorsqu’un contact commence à correspondre à un [segment avec suivi](/fr/docs/segments/tracked/). 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.

> **Les segments sont en alpha:** Les segments sont réservés à l’équipe Emailit pendant que nous les testons. Consultez [Qui peut utiliser les segments](/fr/docs/segments/#who-can-use-segments).

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](/fr/docs/webhooks/webhook-requests/).

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

## Champs

- `event_id` (string): 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](/fr/docs/api-reference/events/get/).

- `type` (string): Toujours `segment.contact_added`.

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

- `data.object` (object): Le même objet, sous la forme que l’[API des événements](/fr/docs/api-reference/events/get/) renvoie dans `data`.

### Objet d’appartenance à un segment

- `object` (string): Toujours `segment_membership`.

- `segment` (object): `id` et `name` du segment.

- `contact` (object): Le contact : `id`, `email`, `first_name`, `last_name` et `custom_fields`.

- `reason` (string): 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_at` (string): Date à laquelle Emailit a enregistré l’entrée, au format ISO 8601 avec décalage UTC.

---
Source: https://emailit.com/fr/docs/webhooks/events/segment/segment-contact-added/

## segment.contact_removed

> Envoyé lorsqu’un contact sort d’un segment avec suivi, avec le segment, le contact, la raison et la date de sortie. Alpha : réservé à l’équipe Emailit.

# segment.contact_removed

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

> **Les segments sont en alpha:** Les segments sont réservés à l’équipe Emailit pendant que nous les testons. Consultez [Qui peut utiliser les segments](/fr/docs/segments/#who-can-use-segments).

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](/fr/docs/webhooks/webhook-requests/).

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

## Champs

- `event_id` (string): 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](/fr/docs/api-reference/events/get/).

- `type` (string): Toujours `segment.contact_removed`.

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

- `data.object` (object): Le même objet, sous la forme que l’[API des événements](/fr/docs/api-reference/events/get/) renvoie dans `data`.

### Objet d’appartenance à un segment

- `object` (string): Toujours `segment_membership`.

- `segment` (object): `id` et `name` du segment.

- `contact` (object): Le contact tel qu’il est maintenant : `id`, `email`, `first_name`, `last_name` et `custom_fields`.

- `reason` (string): 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_at` (string): Date à laquelle Emailit a enregistré la sortie, au format ISO 8601 avec décalage UTC.

---
Source: https://emailit.com/fr/docs/webhooks/events/segment/segment-contact-removed/
