Events

Ein Event ist ein Datensatz darüber, dass in Ihrem Workspace etwas passiert ist: Eine E-Mail wurde zugestellt, ein Link wurde geklickt, eine Nachricht ist auf Ihrer Inbound-Subdomain eingetroffen, ein Kontakt wurde erstellt. Emailit speichert jedes Event, zeigt es in der Weboberfläche an und erstellt daraus jede Webhook-Anfrage. Diese Seite erklärt, wie Sie Events durchsuchen und per API lesen.

Was ein Event enthält

{
  "object": "event",
  "id": "evt_2xGk7Nq1VbD5sR8tLmW3eYhC6aP",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_2xGk7Lr3XcB8pQ1wYzK4dTfG9hJ",
      "object": "email",
      "from": "billing@acme.com",
      "to": "ada@example.com",
      "subject": "Your receipt #1042",
      "status": "delivered",
      "meta": { "order_id": "1042" },
      "updated_at": "2026-10-01T09:14:03.512000+00:00",
      "created_at": "2026-10-01T09:14:01.207000+00:00"
    }
  },
  "created_at": "2026-10-01T09:14:03.540000+00:00"
}

Events und Webhooks

Events sind die Quelle von Webhook-Anfragen. Wenn Emailit ein Event erfasst, reiht es eine Anfrage für jeden aktivierten Webhook ein, der diesen Event-Typ abonniert hat und dessen Payload-Filter passt. Das Event wird gespeichert, unabhängig davon, ob ein Webhook es empfängt.

Das hat zwei Folgen:

• Ein Webhook erhält nur Events, die passieren, während er existiert und aktiviert ist. Events, die erfasst wurden, während ein Webhook deaktiviert war oder bevor er erstellt wurde, werden ihm nicht nachträglich gesendet.
• Sie können die Event-Liste nutzen, um Lücken zu füllen. Lesen Sie nach einem Ausfall oder einer deaktivierten Phase die Events dieses Zeitraums per API und verarbeiten Sie diejenigen, die Ihr Webhook verpasst hat. Deduplizieren Sie anhand der Event-ID, die dieselbe evt_-ID ist, die Webhooks als event_id verwenden.

Events in der Weboberfläche durchsuchen

Öffnen Sie Email API›Events. Die Tabelle zeigt für jedes Event Event type, ID und den Zeitpunkt Created, die neuesten zuerst.

• Standardmäßig zeigt die Seite die letzten 2 Tage. Fügen Sie einen Filter Created hinzu, um innerhalb Ihres Aufbewahrungszeitraums weiter zurückzublicken.
• Filtern Sie nach Type, um nur eine Art von Event zu sehen, zum Beispiel nur email.bounced.
• Wählen Sie ein Event aus, um seinen Zeitpunkt Created, seinen Type und den vollständigen Payload als JSON mit einer Kopierschaltfläche zu sehen.

Events per API lesen

Beide Endpunkte benötigen einen API-Schlüssel mit Full Access.

Events auflisten

Events auflisten gibt Events zurück, die neuesten zuerst.

curl -G https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type=email.bounced,email.complained" \
  --data-urlencode "created_at.after=2026-09-28T00:00:00Z" \
  --data-urlencode "include_data=true"

{
  "data": [
    {
      "object": "event",
      "id": "evt_2xGkB3n8WqZ5cT1vRmK7pLsD4hY",
      "type": "email.bounced",
      "data": { "object": { "id": "em_2xGkA9m1PdX6bR3sQnJ8tKfW2eV", "object": "email", "status": "bounced" } },
      "created_at": "2026-09-30T17:02:41.118000+00:00"
    }
  ],
  "next_page_url": "/v2/events?page=2&limit=100&type=email.bounced%2Cemail.complained&include_data=true",
  "previous_page_url": null
}

Zwei Limits halten diesen Endpunkt schnell:

• Standardzeitraum. Ohne Filter created_at umfasst die Liste die letzten 2 Tage. Fügen Sie created_at.after hinzu, um ältere Events zu lesen.
• Seitentiefe. Der Offset, (page - 1) × limit, darf nicht größer als 2.500 sein. Tiefere Seiten geben 422 mit dem Code events_offset_too_large zurück. Grenzen Sie die Anfrage mit type oder einem Zeitraum in created_at ein, statt weiterzublättern.

Event abrufen

Event abrufen gibt ein Event anhand seiner evt_-ID zurück, immer mit data.

curl https://api.emailit.com/v2/events/evt_2xGk7Nq1VbD5sR8tLmW3eYhC6aP \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Verpasste Webhook-Events abgleichen

1. Zeitraum wählen. Notieren Sie, wann Ihr Endpunkt angefangen hat, Fehler zu liefern, oder wann der Webhook deaktiviert wurde, und wann das Problem behoben war.

2. Events auflisten. Rufen Sie GET /v2/events auf, mit created_at.after und created_at.before auf diesen Zeitraum gesetzt, den type-Werten, die Ihr Webhook verarbeitet, und include_data=true. Folgen Sie next_page_url, bis es null ist. Erhalten Sie events_offset_too_large, teilen Sie den Zeitraum in kürzere Abschnitte auf.

3. Unbekanntes verarbeiten. Überspringen Sie Events, deren ID Sie bereits als verarbeitet gespeichert haben, und verarbeiten Sie den Rest mit demselben Code, den Ihr Webhook verwendet.

Für Anfragen, die eingereiht wurden, aber fehlgeschlagen sind, ist Retry failed beim Webhook einfacher, sofern die Fehlschläge weniger als 7 Tage alt sind.

Aufbewahrung

Events folgen dem Aufbewahrungszeitraum für Logs, genau wie Anfrage-Logs und Webhook-Anfragen:

Siehe auch