# Événements d’abonné

> Contacts ajoutés à une liste, modifiés, ajoutés de nouveau ou retirés.



## subscriber.created

> Envoyé lorsqu’un contact est ajouté à une liste de contacts, via l’API, le tableau de bord, ou lors de la création d’un contact avec des listes.

# subscriber.created

Envoyé lorsqu’un contact est ajouté à une liste de contacts avec [Ajouter un abonné](/fr/docs/api-reference/audiences/subscribers/add/), ou lorsque vous créez ou mettez à jour un contact avec `audiences`. L’ajout d’un contact qui s’était désinscrit de la liste déclenche plutôt [`subscriber.updated`](/fr/docs/webhooks/events/subscriber/updated/) et [`subscriber.resubscribed`](/fr/docs/webhooks/events/subscriber/resubscribed/).

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

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

- `object` (object): L’abonné 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 abonné

- `id` (string): ID de l’abonné (`sub_…`). Un abonné correspond à l’appartenance d’un contact à une liste.

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

- `subscribed` (boolean): Indique si le contact est abonné à la liste.

- `subscribed_at` (string | null): Date d’inscription du contact, ou `null`.

- `unsubscribed_at` (string | null): Date de désinscription du contact, ou `null`.

- `audience` (object): `id` et `name` de la liste.

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

- `created_at` (string): Date d’ajout du contact à la liste, au format ISO 8601 avec décalage UTC.

---
Source: https://emailit.com/fr/docs/webhooks/events/subscriber/subscriber-created/

## subscriber.updated

> Envoyé lorsqu’un abonné change, y compris lorsque le contact se désinscrit d’une liste de contacts ou la rejoint de nouveau.

# subscriber.updated

Envoyé lorsqu’un abonné change : vous le mettez à jour avec [Mettre à jour un abonné](/fr/docs/api-reference/audiences/subscribers/update/), le contact se désinscrit ou se réinscrit, ou un contact qui s’était désinscrit est de nouveau ajouté à la liste. Lorsque le changement provient d’une désinscription ou d’une réinscription, `previous` contient les anciennes valeurs.

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

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

- `object` (object): L’abonné 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 abonné

- `id` (string): ID de l’abonné (`sub_…`). Un abonné correspond à l’appartenance d’un contact à une liste.

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

- `subscribed` (boolean): Indique si le contact est abonné à la liste.

- `subscribed_at` (string | null): Date d’inscription du contact, ou `null`.

- `unsubscribed_at` (string | null): Date de désinscription du contact, ou `null`.

- `audience` (object): `id` et `name` de la liste.

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

- `updated_at` (string): Date de dernière mise à jour de l’abonné, au format ISO 8601 avec décalage UTC.

- `created_at` (string): Date d’ajout du contact à la liste.

- `previous` (object): Anciennes valeurs, présentes lorsque le contact s’est désinscrit ou réinscrit : `subscribed` et `unsubscribed_at`. Absent pour les autres modifications.

---
Source: https://emailit.com/fr/docs/webhooks/events/subscriber/subscriber-updated/

## subscriber.resubscribed

> Envoyé lorsque vous ajoutez de nouveau un contact à une liste de contacts dont il s’était désinscrit. Absent de la liste d’événements du tableau de bord.

# subscriber.resubscribed

Envoyé lorsque vous ajoutez un contact à une liste de contacts dont il s’était désinscrit, avec [Ajouter un abonné](/fr/docs/api-reference/audiences/subscribers/add/). Emailit envoie aussi [`subscriber.updated`](/fr/docs/webhooks/events/subscriber/updated/) avec le même abonné.

`subscriber.resubscribed` ne figure pas dans la liste d’événements du tableau de bord. Vous le recevez sur les webhooks dont `all_events` est activé, ou en l’ajoutant à `events` avec [Mettre à jour un webhook](/fr/docs/api-reference/webhooks/update/).

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

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

- `object` (object): L’abonné 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 abonné

- `id` (string): ID de l’abonné (`sub_…`). Un abonné correspond à l’appartenance d’un contact à une liste.

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

- `subscribed` (boolean): Indique si le contact est abonné à la liste.

- `subscribed_at` (string | null): Date d’inscription du contact, ou `null`.

- `unsubscribed_at` (string | null): Date de désinscription du contact, ou `null`.

- `audience` (object): `id` et `name` de la liste.

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

- `updated_at` (string): Date de dernière mise à jour de l’abonné, au format ISO 8601 avec décalage UTC.

- `created_at` (string): Date d’ajout du contact à la liste.

- `resubscribed` (boolean): Toujours `true`.

---
Source: https://emailit.com/fr/docs/webhooks/events/subscriber/subscriber-resubscribed/

## subscriber.deleted

> Envoyé lorsqu’un contact est retiré d’une liste de contacts, y compris lorsque le contact lui-même est supprimé.

# subscriber.deleted

Envoyé lorsqu’un contact est retiré d’une liste de contacts : avec [Supprimer un abonné](/fr/docs/api-reference/audiences/subscribers/delete/), lorsque vous modifiez les `audiences` d’un contact, ou lorsque vous supprimez le contact. Le payload correspond à l’abonné tel qu’il était avant son retrait.

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

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

- `object` (object): L’abonné 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 abonné

- `id` (string): ID de l’abonné (`sub_…`). Un abonné correspond à l’appartenance d’un contact à une liste.

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

- `subscribed` (boolean): Indique si le contact est abonné à la liste.

- `subscribed_at` (string | null): Date d’inscription du contact, ou `null`.

- `unsubscribed_at` (string | null): Date de désinscription du contact, ou `null`.

- `audience` (object): `id` et `name` de la liste.

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

- `updated_at` (string): Date de dernière mise à jour de l’abonné, au format ISO 8601 avec décalage UTC.

- `created_at` (string): Date d’ajout du contact à la liste.

---
Source: https://emailit.com/fr/docs/webhooks/events/subscriber/subscriber-deleted/