É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.

i

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.

i

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

  • event

    Valeur fixe : "tracking_preferences_updated"

  • timestamp

    Date de traitement de la modification (ISO 8601, UTC).

  • data.recipientEmail

    Le destinataire qui a modifié sa préférence.

  • data.trackOpens

    true : le destinataire autorise le suivi des ouvertures. false : il l’a refusé.

  • data.trackClicks

    true : le destinataire autorise le suivi des clics. false : il l’a refusé.

  • data.source

    Valeur fixe pour le moment : "page" (le destinataire a utilisé la page des préférences de suivi).

  • data.updatedAt

    Date d'enregistrement de la préférence (ISO 8601, UTC). Même valeur que updated_at dans l'API.

  • data.campaignId

    La campagne de l'e-mail d'où vient le destinataire. Uniquement pour les e-mails de campagne.

  • data.trackId

    Clé 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.