Dokumentation Webhooks Ereignisse

email.accepted

Wird ausgelöst, wenn eine E-Mail zur Zustellung angenommen wurde.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.accepted",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Willkommen bei Emailit",
      "meta": { "campaign": "welcome-series" },
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

meta object | null

Benutzerdefinierte Metadaten, die an die E-Mail angehängt sind.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.scheduled

Wird ausgelöst, wenn eine E-Mail für die zukünftige Zustellung geplant wird.

{
  "event_id": "2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.scheduled",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Weekly Digest",
      "meta": { "series": "weekly" },
      "scheduled_at": "2026-02-15T09:00:00.000000+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

meta object | null

Benutzerdefinierte Metadaten, die an die E-Mail angehängt sind.

scheduled_at string

ISO 8601-Zeitstempel für die geplante Zustellung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.delivered

Wird ausgelöst, wenn eine E-Mail erfolgreich an den Mailserver des Empfängers zugestellt wurde.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Willkommen bei Emailit",
      "status": "delivered",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

status string

Immer delivered.

meta object | null

Benutzerdefinierte Metadaten, die der E-Mail angehängt sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.bounced

Wird ausgelöst, wenn eine E-Mail dauerhaft nicht zugestellt werden kann (Hard Bounce).

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.bounced",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Willkommen bei Emailit",
      "status": "bounced",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

Absender-E-Mail-Adresse.

to string

Empfänger-E-Mail-Adresse.

subject string

E-Mail-Betreffzeile.

status string

Immer bounced.

meta object | null

Benutzerdefinierte Metadaten, die der E-Mail zugeordnet sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.attempted

Wird ausgelöst, wenn ein E-Mail-Versandversuch unternommen wird, aber zu einem temporären Fehler führt.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.attempted",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "attempted",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

status string

Immer attempted.

meta object | null

Benutzerdefinierte Metadaten, die der E-Mail zugeordnet sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.failed

Wird ausgelöst, wenn eine E-Mail nicht zugestellt werden kann, meist aufgrund eines spezifischen Fehlers während der Zustellung.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.failed",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "failed",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

status string

Immer failed.

meta object | null

Benutzerdefinierte Metadaten, die der E-Mail zugeordnet sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.rejected

Wird ausgelöst, wenn eine E-Mail zur Zustellung angenommen, aber anschließend abgelehnt wurde.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.rejected",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "rejected",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

status string

Immer rejected.

meta object | null

Benutzerdefinierte Metadaten, die der E-Mail zugeordnet sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.suppressed

Wird ausgelöst, wenn sich der E-Mail-Empfänger auf der Sperrliste befindet.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.suppressed",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Willkommen bei Emailit",
      "status": "suppressed",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

status string

Immer suppressed.

meta object | null

Benutzerdefinierte Metadaten, die der E-Mail zugeordnet sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.received

Wird ausgelöst, wenn eine eingehende E-Mail angenommen wird.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.received",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Willkommen bei Emailit",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

created_at string

ISO 8601 Zeitstempel, wann die E-Mail empfangen wurde.

email.complained

Wird ausgelöst, wenn eine Beschwerde für diese E-Mail registriert wird (z.B. als Spam markiert).

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.complained",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "complained",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige E-Mail-Kennung.

object string

Immer email.

from string

E-Mail-Adresse des Absenders.

to string

E-Mail-Adresse des Empfängers.

subject string

Betreffzeile der E-Mail.

status string

Immer complained.

meta object | null

Benutzerdefinierte Metadaten, die an die E-Mail angehängt sind.

updated_at string

ISO 8601-Zeitstempel der Statusänderung.

created_at string

ISO 8601-Zeitstempel der E-Mail-Erstellung.

email.clicked

Wird ausgelöst, wenn ein Link innerhalb einer E-Mail angeklickt wird. Enthält Klick-Details wie IP-Adresse, User-Agent und die angeklickte URL.

{
  "event_id": "...",
  "type": "email.clicked",
  "data": {
    "object": {
      "id": "click_4yM2nTvR8oPcX3u...",
      "object": "click",
      "email": {
        "id": "em_...",
        "rcpt_to": "empfaenger@example.com",
        "mail_from": "absender@example.com",
        "subject": "Willkommen",
        "created_at": "...",
        "meta": null
      },
      "link": {
        "id": "link_...",
        "url": "https://example.com/seite"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 ...",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige Klick-Kennung.

object string

Immer click.

email object

Die E-Mail, die angeklickt wurde.

email.id string

E-Mail-Kennung.

email.rcpt_to string

E-Mail-Adresse des Empfängers.

email.mail_from string

E-Mail-Adresse des Absenders.

email.subject string

Betreffzeile der E-Mail.

email.meta object | null

Benutzerdefinierte Metadaten, die an die E-Mail angehängt sind.

link.id string

Link-Kennung.

link.url string

Die URL, die angeklickt wurde.

ip_address string

IP-Adresse des Klicks.

user_agent string

User-Agent-String des Clients.

created_at string

ISO 8601 Zeitstempel des Klicks.

email.loaded

Wird ausgelöst, wenn der E-Mail-Inhalt vom Empfänger geladen wird. Enthält Tracking-Details wie IP-Adresse und User-Agent.

{
  "event_id": "...",
  "type": "email.loaded",
  "data": {
    "object": {
      "id": "load_4yM2nTvR8oPcX3u...",
      "object": "load",
      "email": {
        "id": "em_...",
        "rcpt_to": "empfaenger@example.com",
        "mail_from": "absender@example.com",
        "subject": "Willkommen",
        "created_at": "...",
        "meta": null
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 ...",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Felder

id string

Eindeutige Lade-Kennung.

object string

Immer load.

email object

Die E-Mail, die geladen wurde.

email.id string

E-Mail-Kennung.

email.rcpt_to string

E-Mail-Adresse des Empfängers.

email.mail_from string

E-Mail-Adresse des Absenders.

email.subject string

Betreffzeile der E-Mail.

email.meta object | null

Benutzerdefinierte Metadaten, die an die E-Mail angehängt sind.

ip_address string

IP-Adresse des Ladevorgangs.

user_agent string

User-Agent-String des Clients.

created_at string

ISO 8601-Zeitstempel des Ladevorgangs.

Lokalisiert durch KI