# Événements de contact

> Contacts créés, mis à jour ou supprimés.



## contact.created

> Envoyé lorsqu’un contact est créé via l’API ou le tableau de bord. Contient les listes auxquelles il a été ajouté.

# contact.created

Envoyé lorsqu’un contact est créé avec [Créer un contact](/fr/docs/api-reference/contacts/create/). Si vous transmettez `audiences`, Emailit envoie aussi [`subscriber.created`](/fr/docs/webhooks/events/subscriber/created/) pour chaque liste.

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

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

- `object` (object): Le contact 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 contact

- `id` (string): ID du contact (`con_…`).

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

- `email` (string): Adresse du contact, en minuscules.

- `first_name` (string | null): Prénom.

- `last_name` (string | null): Nom.

- `custom_fields` (object): Valeurs des champs personnalisés, indexées par champ. Consultez [Champs personnalisés](/fr/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Indique si le contact est désinscrit de toutes les campagnes.

- `created_at` (string): Date de création du contact, au format ISO 8601 avec décalage UTC.

- `audiences` (object[]): Listes auxquelles appartient le contact. Chaque élément contient l’`id` de la liste et un objet `subscriber` avec `id`, `subscribed`, `subscribed_at` et `unsubscribed_at`.

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

## contact.updated

> Envoyé lorsqu’un contact change. Contient les valeurs précédentes des champs modifiés, comme l’adresse e-mail ou le nom.

# contact.updated

Envoyé lorsqu’un contact change, avec [Mettre à jour un contact](/fr/docs/api-reference/contacts/update/) ou les actions `unsubscribe` et `resubscribe` des [actions groupées sur les contacts](/fr/docs/api-reference/contacts/bulk/). Les modifications de listes déclenchent aussi des [événements d’abonné](/fr/docs/webhooks/events/subscriber/).

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

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

- `object` (object): Le contact 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 contact

- `id` (string): ID du contact (`con_…`).

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

- `email` (string): Adresse du contact, en minuscules.

- `first_name` (string | null): Prénom.

- `last_name` (string | null): Nom.

- `custom_fields` (object): Valeurs des champs personnalisés, indexées par champ. Consultez [Champs personnalisés](/fr/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Indique si le contact est désinscrit de toutes les campagnes.

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

- `created_at` (string): Date de création du contact.

- `audiences` (object[]): Listes auxquelles appartient le contact. Chaque élément contient l’`id` de la liste et un objet `subscriber` avec `id`, `subscribed`, `subscribed_at` et `unsubscribed_at`.

- `previous` (object): Anciennes valeurs des champs modifiés parmi `email`, `first_name`, `last_name`, `unsubscribed` et `custom_fields`. Absent lorsqu’aucun d’eux n’a changé.

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

## contact.deleted

> Envoyé lorsqu’un contact est supprimé. Le payload correspond au contact, avec ses listes, tel qu’il était avant sa suppression.

# contact.deleted

Envoyé lorsqu’un contact est supprimé avec [Supprimer un contact](/fr/docs/api-reference/contacts/delete/) ou l’action groupée `delete`. Emailit envoie d’abord [`subscriber.deleted`](/fr/docs/webhooks/events/subscriber/deleted/) pour chaque liste à laquelle le contact appartenait.

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

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

- `object` (object): Le contact 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 contact

- `id` (string): ID du contact (`con_…`).

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

- `email` (string): Adresse du contact, en minuscules.

- `first_name` (string | null): Prénom.

- `last_name` (string | null): Nom.

- `custom_fields` (object): Valeurs des champs personnalisés, indexées par champ. Consultez [Champs personnalisés](/fr/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Indique si le contact est désinscrit de toutes les campagnes.

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

- `created_at` (string): Date de création du contact.

- `audiences` (object[]): Listes auxquelles appartient le contact. Chaque élément contient l’`id` de la liste et un objet `subscriber` avec `id`, `subscribed`, `subscribed_at` et `unsubscribed_at`.

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