Aller au contenu
Docs

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 avec Ajouter un abonné, 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 et subscriber.resubscribed.

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

objectobject

L’abonné 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 abonné

idstring

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

objectstring

Toujours subscriber.

subscribedboolean

Indique si le contact est abonné à la liste.

subscribed_atstring | null

Date d’inscription du contact, ou null.

unsubscribed_atstring | null

Date de désinscription du contact, ou null.

audienceobject

id et name de la liste.

contactobject

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

created_atstring

Date d’ajout du contact à la liste, au format ISO 8601 avec décalage UTC.

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

subscriber.updated

Envoyé lorsqu’un abonné change : vous le mettez à jour avec Mettre à jour un abonné, 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.

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

objectobject

L’abonné 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 abonné

idstring

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

objectstring

Toujours subscriber.

subscribedboolean

Indique si le contact est abonné à la liste.

subscribed_atstring | null

Date d’inscription du contact, ou null.

unsubscribed_atstring | null

Date de désinscription du contact, ou null.

audienceobject

id et name de la liste.

contactobject

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

updated_atstring

Date de dernière mise à jour de l’abonné, au format ISO 8601 avec décalage UTC.

created_atstring

Date d’ajout du contact à la liste.

previousobject

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

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

subscriber.resubscribed

Envoyé lorsqu’un contact qui s’était désinscrit d’une liste de contacts y est de nouveau inscrit : avec Ajouter un abonné, via un formulaire, l’URL d’inscription de la liste, une confirmation de double opt-in ou la page de gestion des abonnements, ou par une étape Add to audience ou Subscribe / unsubscribe d’une automatisation. Emailit envoie aussi subscriber.updated avec le même abonné.

Dans le tableau de bord, il figure dans le groupe Subscribers du sélecteur d’événements, et vous pouvez en envoyer un test. Les webhooks dont all_events est activé le reçoivent aussi.

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

objectobject

L’abonné 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 abonné

idstring

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

objectstring

Toujours subscriber.

subscribedboolean

Indique si le contact est abonné à la liste.

subscribed_atstring | null

Date d’inscription du contact, ou null.

unsubscribed_atstring | null

Date de désinscription du contact, ou null.

audienceobject

id et name de la liste.

contactobject

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

updated_atstring

Date de dernière mise à jour de l’abonné, au format ISO 8601 avec décalage UTC.

created_atstring

Date d’ajout du contact à la liste.

resubscribedboolean

Toujours true.

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

subscriber.deleted

Envoyé lorsqu’un contact est retiré d’une liste de contacts : avec Supprimer un abonné, 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.

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

objectobject

L’abonné 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 abonné

idstring

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

objectstring

Toujours subscriber.

subscribedboolean

Indique si le contact est abonné à la liste.

subscribed_atstring | null

Date d’inscription du contact, ou null.

unsubscribed_atstring | null

Date de désinscription du contact, ou null.

audienceobject

id et name de la liste.

contactobject

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

updated_atstring

Date de dernière mise à jour de l’abonné, au format ISO 8601 avec décalage UTC.

created_atstring

Date d’ajout du contact à la liste.

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

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.