Webhook-Event · Tracking

tracking_preferences_updated

Wird gesendet, wenn ein Empfänger auf der Seite für Tracking-Einstellungen seine Wahl zum Öffnungs- oder Klick-Tracking ändert. Er erhält Ihre E-Mails weiterhin: Das ist keine Abmeldung.

i

Wird als signierter POST an Ihre Webhook-URL gesendet. Unter Einrichtung & Events erfahren Sie, wie Sie die Signatur prüfen.

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

Nur wenn sich etwas geändert hat Wird dieselbe Wahl erneut gespeichert, wird kein Webhook gesendet. Änderungen, die Sie selbst mit Set Preferences vornehmen, werden ebenfalls nicht gesendet, damit Ihr CRM-Sync nie in eine Schleife gerät. Eine Ablehnung gilt sofort für Ihre Sendungen: E-Mails, die mit "unsubscribe": true gesendet werden, enthalten für diesen Empfänger weder Pixel noch getrackte Links.

i

Tracking-Einstellungen-API Lesen Sie einen Empfänger oder 100 auf einmal, sehen Sie den vollständigen Verlauf eines Empfängers und fragen Sie jede Änderung per Cursor ab.

Tracking-Einstellungen →

Feldreferenz

  • event

    Fester Wert: "tracking_preferences_updated"

  • timestamp

    Wann die Änderung verarbeitet wurde (ISO 8601, UTC).

  • data.recipientEmail

    Der Empfänger, der seine Einstellung geändert hat.

  • data.trackOpens

    true: Der Empfänger erlaubt Öffnungs-Tracking. false: Er hat es abgelehnt.

  • data.trackClicks

    true: Der Empfänger erlaubt Klick-Tracking. false: Er hat es abgelehnt.

  • data.source

    Vorerst fester Wert: "page" (der Empfänger hat die Seite für Tracking-Einstellungen genutzt).

  • data.updatedAt

    Wann die Einstellung gespeichert wurde (ISO 8601, UTC). Derselbe Wert wie updated_at in der API.

  • data.campaignId

    Die Kampagne der E-Mail, über die der Empfänger kam. Nur für Kampagnen-E-Mails.

  • data.trackId

    Tracking-Schlüssel der E-Mail, für über die API oder SMTP gesendete E-Mails. Nur wenn Tracking für diesen Versand aktiv war.