Events aus Ihrem Backend senden

Senden Sie Events von Ihren Servern für alles, was nicht vom Browser des Besuchers abhängen darf, etwa Bestellungen, Zahlungen, Abo-Änderungen oder Events aus einem Backoffice. Diese Seite zeigt, wie Sie ein Event senden, wie Sie viele senden und wie Sie mit Fehlern umgehen.

Voraussetzungen

• Das Senden von Events ist in den Tarifen Pro, Business und Custom enthalten. Ein Workspace mit Pro kann 100 Event-Typen nutzen, ein Workspace mit Business 1.000. Siehe Limits.
• Erstellen Sie unter Email API›API Keys einen API-Schlüssel mit dem Scope Events Only. Er kann Events senden und sonst nichts: Er kann Ihre Daten nicht lesen, keine Event-Definitionen verwalten und keine E-Mails senden. Ein Schlüssel mit Full Access funktioniert ebenfalls. Siehe API-Schlüssel.
• Um Workspace-Events zu senden, definieren Sie sie zuerst. Eigene Events brauchen keine Einrichtung.

Event senden

Rufen Sie Event senden mit dem type des Events, seinen properties und der Person auf, um die es geht:

curl -X POST https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "c:order.completed",
    "email": "jane@example.com",
    "properties": { "order_id": "1001", "total": 59.9, "currency": "EUR" },
    "occurred_at": "2026-10-19T09:30:00Z"
  }'

• email ordnet das Event dem Kontakt mit dieser Adresse zu. Wenn Sie die ID des Kontakts bereits kennen, senden Sie stattdessen contact_id.
• occurred_at gibt an, wann es passiert ist, zum Beispiel wenn Sie Events aus einer Warteschlange senden. Lassen Sie das Feld weg, um die aktuelle Zeit zu verwenden.
• Die Antwort ist 201 mit dem gespeicherten Event und seiner evt_-ID. Ein reiner Event-Schlüssel erhält das Event ohne data zurück.

Viele Events auf einmal senden

Events gesammelt senden nimmt bis zu 100 Events in einer Anfrage an und eignet sich damit für Importe und geplante Synchronisierungen:

curl -X POST https://api.emailit.com/v2/events/batch \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      { "type": "c:order.completed", "email": "jane@example.com", "properties": { "order_id": "1001", "total": 59.9 } },
      { "type": "c:order.completed", "email": "omar@example.com", "properties": { "order_id": "1002", "total": 18 } }
    ]
  }'

Ein Batch gilt ganz oder gar nicht: Ist ein Event ungültig, wird keines gespeichert. Die Antwort mit 422 führt jedes Problem unter events.<index> auf, sodass Sie diese Events korrigieren oder weglassen und den Batch erneut senden können.

Fehler behandeln

Events haben keinen Idempotenzschlüssel. Wiederholen Sie eine Anfrage, die bereits durchgegangen ist, wird das Event also zweimal gespeichert. Legen Sie Ihre eigene ID in die Eigenschaften, etwa order_id, damit alle, die die Events lesen, Duplikate erkennen können.

Prüfen, ob Events ankommen

Öffnen Sie Email API›Events. Der Tab Log listet neue Events oben auf; setzen Sie Scope auf Custom oder Workspace, um System-Events auszublenden. Wählen Sie ein Event aus, um seine Eigenschaften, den zugehörigen Kontakt und seine Herkunft zu sehen. Events, die einem Kontakt zugeordnet sind, erscheinen außerdem im Activity log des Kontakts.

Siehe auch