# Events

> Durchsuchen Sie die Events, die Emailit für Ihren Workspace erfasst, in der Weboberfläche oder mit der Events-API, und nutzen Sie sie, um Webhooks nachzuholen oder abzugleichen.

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](/de/docs/webhooks/)-Anfrage. Diese Seite erklärt, wie Sie Events durchsuchen und per API lesen.

## Was ein Event enthält

| Feld | Beschreibung |
| --- | --- |
| `id` | Die Event-ID, beginnend mit `evt_`. In Webhook-Anfragen heißt sie `event_id`. |
| `type` | Was passiert ist, zum Beispiel `email.delivered` oder `contact.created`. Siehe [Event-Typen](/de/docs/webhooks/event-types/). |
| `data.object` | Die Ressource, um die es im Event geht, etwa die E-Mail, der Klick, die Domain oder der Kontakt, so wie sie zum Zeitpunkt des Events war. |
| `created_at` | Wann das Event erfasst wurde. |

```json
{
  "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](/de/docs/webhooks/set-up/#filter-events-by-payload) 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](/de/docs/api-reference/events/list/) gibt Events zurück, die neuesten zuerst.

| Query-Parameter | Beschreibung |
| --- | --- |
| `type` | Ein Typ oder mehrere, durch Kommas getrennt, zum Beispiel `email.bounced,email.complained`. |
| `include_data` | `true`, um `data` für jedes Event einzuschließen. Standardwert: `false`, dann werden nur `id`, `type` und `created_at` zurückgegeben. |
| `page`, `limit` | Seitennummer und Seitengröße. `limit` liegt zwischen 1 und 100, Standardwert 100. |
| `created_at.after`, `created_at.before` | Datumsfilter. Siehe [Filtern und Sortieren](/de/docs/api-reference/filtering/). |

```bash
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"
```

```json
{
  "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](/de/docs/api-reference/events/get/) gibt ein Event anhand seiner `evt_`-ID zurück, immer mit `data`.

```bash
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](/de/docs/webhooks/retries-and-failures/#retry-failed-requests) 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:

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Aufbewahrung der Anfrage-Logs | 7 Tage | 30 Tage | 30 Tage | Flexibel |

## Siehe auch

  - [Event-Typen](/de/docs/webhooks/event-types/)
  - [Events-API](/de/docs/api-reference/events/)

---
Quelle: https://emailit.com/de/docs/logs/events/