Webhook-Event · Tracking

email_opened

Wird gesendet, wenn ein Empfänger eine E-Mail mit aktivem Öffnungs-Tracking öffnet. Enthält Gerät, IP, Land und ob die Öffnung über einen Proxy kam.

i

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

Payload

// Opened (API / SMTP email)
{
  "event": "email_opened",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T05:12:44.000Z",
  "data": {
    "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
    "recipientEmail": "john.doe@example.com",
    "track": "a41f9c0e7b2d58e6",
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
    "ip": "203.112.45.78",
    "location": "MY",
    "isProxy": false,
    "isFirstOpen": true
  }
}
!

Auch Proxy-Öffnungen werden gesendet. Öffnungen über einen Proxy senden dieses Event trotzdem, markiert mit isProxy: true. Filtern Sie danach, wenn Sie nur Öffnungen möchten, die sicher von einer Person stammen.

Feldreferenz

  • event

    Fester Wert: "email_opened".

  • emailId

    ID der geöffneten E-Mail. Wird auch in data.emailId wiederholt.

  • timestamp

    Wann die Öffnung stattfand (ISO 8601, UTC).

  • data.recipientEmail

    Wer sie geöffnet hat.

  • data.track

    Nur für API- / SMTP-E-Mails, die mit einem track gesendet wurden: der Track-Schlüssel.

  • data.campaignId

    Nur für Kampagnen-E-Mails: die Kampagnen-ID.

  • data.userAgent

    User Agent des Requests, der das Bild geladen hat.

  • data.ip

    IP-Adresse dieses Requests.

  • data.location

    Ländercode dieser IP, etwa "MY" oder "US".

  • data.isProxy

    True, wenn die Öffnung über einen Postfach-Proxy oder -Scanner kam (Gmail-Bildproxy, Apple-Mail-Datenschutz) und nicht direkt vom Empfänger.

  • data.isFirstOpen

    True beim ersten Öffnen dieser E-Mail durch diesen Empfänger. Kann null sein, wenn es sich nicht feststellen lässt.