Événement webhook · Suivi
tracking_preferences_updated
Envoyé lorsqu'un destinataire modifie son choix de suivi des ouvertures ou des clics sur la page des préférences de suivi. Il continue de recevoir vos e-mails : ce n'est pas un désabonnement.
Envoyé sous forme de requête POST signée vers votre URL de webhook. Consultez Configuration et événements pour savoir comment vérifier la signature.
Payload
// Turned open tracking off (API / SMTP email)
{
"event": "tracking_preferences_updated",
"timestamp": "2026-10-24T07:20:12.031Z",
"data": {
"recipientEmail": "jane.doe@example.com",
"trackOpens": false,
"trackClicks": true,
"source": "page",
"updatedAt": "2026-10-24T07:20:12.031Z",
"trackId": "a41f9c0e7b2d58e6"
}
}Uniquement en cas de changement Enregistrer à nouveau le même choix n'envoie pas le webhook. Les modifications que vous faites vous-même avec Set Preferences ne sont pas envoyées non plus, donc la synchronisation avec votre CRM ne boucle jamais. Un refus s'applique immédiatement à vos envois : les e-mails envoyés avec "unsubscribe": true n'incluent ni le pixel ni les liens suivis pour ce destinataire.
API des préférences de suivi Lisez un destinataire ou 100 à la fois, consultez l'historique complet d'un destinataire et récupérez chaque modification avec un curseur.
Préférences de suivi →Référence des champs
eventValeur fixe : "tracking_preferences_updated"
timestampDate de traitement de la modification (ISO 8601, UTC).
data.recipientEmailLe destinataire qui a modifié sa préférence.
data.trackOpenstrue : le destinataire autorise le suivi des ouvertures. false : il l’a refusé.
data.trackClickstrue : le destinataire autorise le suivi des clics. false : il l’a refusé.
data.sourceValeur fixe pour le moment : "page" (le destinataire a utilisé la page des préférences de suivi).
data.updatedAtDate d'enregistrement de la préférence (ISO 8601, UTC). Même valeur que updated_at dans l'API.
data.campaignIdLa campagne de l'e-mail d'où vient le destinataire. Uniquement pour les e-mails de campagne.
data.trackIdClé de suivi de l'e-mail, pour les e-mails envoyés via l'API ou SMTP. Uniquement si le suivi était activé pour cet envoi.