Événements de liste de contacts
Listes de contacts créées, mises à jour ou supprimées.
audience.created
Envoyé lorsqu’une liste de contacts est créée, par exemple avec Créer une liste de contacts.
Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.
Champs
event_idstringID 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.
typestringToujours audience.created.
objectobjectLa liste de contacts décrite par l’événement. Ses champs sont détaillés ci-dessous.
data.objectobjectLe même objet, sous la forme que l’API des événements renvoie dans data.
Objet liste de contacts
idstringID de la liste (aud_…).
objectstringToujours audience.
namestringNom de la liste.
created_atstringDate de création de la liste, au format ISO 8601 avec décalage UTC.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "audience.created",
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Newsletter",
"created_at": "2026-10-01T10:02:11.583000+00:00"
},
"data": {
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Newsletter",
"created_at": "2026-10-01T10:02:11.583000+00:00"
}
}
}audience.updated
Envoyé lorsqu’une liste de contacts change, par exemple lorsque vous la renommez avec Mettre à jour une liste de contacts. Les modifications d’abonnés déclenchent plutôt des événements d’abonné.
Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.
Champs
event_idstringID 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.
typestringToujours audience.updated.
objectobjectLa liste de contacts décrite par l’événement. Ses champs sont détaillés ci-dessous.
data.objectobjectLe même objet, sous la forme que l’API des événements renvoie dans data.
Objet liste de contacts
idstringID de la liste (aud_…).
objectstringToujours audience.
namestringNom de la liste.
updated_atstringDate de dernière mise à jour de la liste, au format ISO 8601 avec décalage UTC.
created_atstringDate de création de la liste.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "audience.updated",
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-10-01T10:02:14.307000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
},
"data": {
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-10-01T10:02:14.307000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
}
}
}audience.deleted
Envoyé lorsqu’une liste de contacts est supprimée, par exemple avec Supprimer une liste de contacts. Le payload correspond à la liste telle qu’elle était avant sa suppression.
Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.
Champs
event_idstringID 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.
typestringToujours audience.deleted.
objectobjectLa liste de contacts décrite par l’événement. Ses champs sont détaillés ci-dessous.
data.objectobjectLe même objet, sous la forme que l’API des événements renvoie dans data.
Objet liste de contacts
idstringID de la liste (aud_…).
objectstringToujours audience.
namestringNom de la liste.
updated_atstringDate de dernière mise à jour de la liste, au format ISO 8601 avec décalage UTC.
created_atstringDate de création de la liste.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "audience.deleted",
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-09-30T08:14:02.771000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
},
"data": {
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-09-30T08:14:02.771000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
}
}
}