E-Mail-Events

Der Lebenszyklus jeder ausgehenden und eingehenden E-Mail, von der Annahme über die Zustellung bis zu Öffnungen, Klicks und Abmeldungen.

email.accepted
email.scheduled
email.delivered
email.attempted
email.bounced
email.failed
email.rejected
email.suppressed
email.held
email.canceled
email.complained
email.received
email.loaded
email.clicked
email.unsubscribed
email.resubscribed

email.accepted

Wird gesendet, wenn E-Mail senden oder E-Mail weiterleiten eine E-Mail zur sofortigen Zustellung annimmt. Emailit sendet ein Event pro Empfänger, weil jeder Empfänger eine eigene E-Mail-ID erhält. Per SMTP eingereichte E-Mails und mit E-Mail erneut senden erstellte E-Mails lösen dieses Event nicht aus.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

Event-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.

typestring

Immer email.accepted.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absender wie in der Anfrage angegeben. Kann einen Anzeigenamen enthalten, zum Beispiel Acme <hello@acme.com>.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail mit eigener ID.

subjectstring

Betreffzeile.

metaobject | null

Das Objekt meta, das Sie mit der E-Mail gesendet haben, oder null.

timestampstring

Zeitpunkt, zu dem die E-Mail angenommen wurde, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.accepted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "meta": {
      "order_id": "1042"
    },
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "meta": {
        "order_id": "1042"
      },
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.scheduled

Wird gesendet, wenn E-Mail senden eine E-Mail mit einem in der Zukunft liegenden scheduled_at annimmt. Emailit sendet ein Event pro Empfänger. Ist der geplante Zeitpunkt erreicht, sendet Emailit die E-Mail ohne ein Event email.accepted; das nächste Event ist ein Zustellungs-Event wie email.delivered.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.scheduled.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absender wie in der Anfrage angegeben. Kann einen Anzeigenamen enthalten, zum Beispiel Acme <hello@acme.com>.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail mit eigener ID.

subjectstring

Betreffzeile.

metaobject | null

Das Objekt meta, das Sie mit der E-Mail gesendet haben, oder null.

scheduled_atstring

Zeitpunkt, zu dem Emailit die E-Mail senden wird.

timestampstring

Zeitpunkt, zu dem die E-Mail angenommen wurde, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.scheduled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.delivered

Wird gesendet, wenn der Mailserver des Empfängers die E-Mail annimmt. „Zugestellt“ bedeutet, dass der Empfangsserver die Verantwortung für die Nachricht übernommen hat; er kann sie trotzdem in einen Spam-Ordner filtern. E-Mail-Status erklärt jeden Status.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.delivered.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer delivered.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.delivered",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "delivered",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "delivered",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.attempted

Wird jedes Mal gesendet, wenn ein Zustellversuch mit einem vorübergehenden Fehler scheitert, etwa durch Greylisting oder ein Rate Limit beim Empfangsserver, und Emailit es erneut versucht. Emailit wiederholt den Versuch etwa 21 Stunden lang in wachsenden Abständen; scheitert die Zustellung dann immer noch, gilt die E-Mail als gebounct und Sie erhalten email.bounced.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.attempted.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer attempted.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

smtp_codeinteger | null

SMTP-Antwortcode des Empfangsservers, zum Beispiel 421. null, wenn Emailit den Versuch selbst verschoben hat, etwa während eines Zustell-Backoffs für diesen Server.

smtp_enhanced_codestring | null

Erweiterter Statuscode aus der Antwort, zum Beispiel 4.7.0. Siehe Erweiterte Statuscodes.

smtp_responsestring | null

Vollständige Antwort des Empfangsservers.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.attempted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "attempted",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "smtp_code": 421,
    "smtp_enhanced_code": "4.7.0",
    "smtp_response": "421 4.7.0 Try again later, closing connection."
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "attempted",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "smtp_code": 421,
      "smtp_enhanced_code": "4.7.0",
      "smtp_response": "421 4.7.0 Try again later, closing connection."
    }
  }
}

email.bounced

Wird gesendet, wenn eine E-Mail nicht zugestellt werden kann: Der Empfangsserver hat sie mit einem dauerhaften Fehler abgelehnt, nach der Zustellung ist eine Bounce-Benachrichtigung eingetroffen, alle Wiederholungsversuche sind gescheitert oder Emailit konnte sie gar nicht senden, zum Beispiel weil ihre Versanddomain gelöscht wurde. Je nach Ihren Einstellungen für die automatische Sperrung setzt Emailit die Adresse außerdem auf die Sperrliste. Siehe Bounces und Beschwerden.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.bounced.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer bounced.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.bounced",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "bounced",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "bounced",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.failed

Wird gesendet, wenn Emailit eine Bounce-Benachrichtigung, die an der Return-Path-Adresse Ihres Workspaces eingegangen ist, nicht verarbeiten kann, zum Beispiel wegen eines internen Fehlers. Das Objekt beschreibt die Bounce-Nachricht, nicht die E-Mail, die Sie gesendet haben. Dieses Event ist selten: Fehlgeschlagene Zustellungen lösen email.bounced oder email.attempted aus.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.failed.

objectobject

Die Bounce-Nachricht, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…) der Bounce-Nachricht.

objectstring

Immer email.

fromstring

Absender der Bounce-Nachricht, meist der Mailer-Daemon des Empfangsservers.

tostring

Die Return-Path-Adresse Ihres Workspaces auf der Subdomain emailit. Ihrer Versanddomain.

subjectstring | null

Betreff der Bounce-Nachricht.

statusstring

Immer failed.

metaobject | null

Bei Bounce-Nachrichten immer null.

updated_atstring

Zeitpunkt der letzten Aktualisierung der Bounce-Nachricht vor diesem Event, im Format ISO 8601 mit UTC-Offset.

created_atstring

Zeitpunkt, zu dem Emailit die Bounce-Nachricht empfangen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.failed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "mailer-daemon@mx1.example.com",
    "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
    "subject": "Undelivered Mail Returned to Sender",
    "status": "failed",
    "meta": null,
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "mailer-daemon@mx1.example.com",
      "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
      "subject": "Undelivered Mail Returned to Sender",
      "status": "failed",
      "meta": null,
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.rejected

Wird gesendet, wenn Emailit den Versand einer E-Mail verweigert, weil Ihr Workspace noch keinen Produktionszugang hat und der Empfänger kein Mitglied des Workspaces ist. Bis der Workspace genehmigt ist, können Sie nur an die E-Mail-Adressen der Konten von Workspace-Mitgliedern senden.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.rejected.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer rejected.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.rejected",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "rejected",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "rejected",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.suppressed

Wird gesendet, wenn Emailit eine E-Mail nicht sendet, weil für den Empfänger eine Sperrung vom Typ recipient auf Ihrer Sperrliste steht. Um wieder an die Adresse zu senden, entfernen Sie sie mit Sperrung löschen.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.suppressed.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer suppressed.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.suppressed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "suppressed",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "suppressed",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.held

Wird gesendet, wenn Emailit eine E-Mail zurückhält, statt sie zu senden. Das passiert, wenn der Workspace gesperrt ist, die Versanddomain pausiert ist, der API-Schlüssel auf das Zurückhalten von Nachrichten eingestellt ist, der Workspace keine Credits mehr hat oder der Score der Spam-Prüfung den Schwellenwert erreicht oder überschreitet (standardmäßig 7). Wenn Sie die Ursache behoben haben, senden Sie die E-Mail mit E-Mail erneut senden noch einmal.

email.held steht nicht in der Event-Liste der Weboberfläche. Sie erhalten es auf Webhooks, bei denen all_events aktiviert ist, oder indem Sie es mit Webhook aktualisieren zu events hinzufügen.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.held.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer held.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.held",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "held",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "held",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.canceled

Wird gesendet, wenn Sie eine E-Mail mit E-Mail stornieren stornieren. Lief bereits ein Zustellversuch, kann er noch abgeschlossen werden, sodass ein Zustellungs-Event folgen kann.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.canceled.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absender, wie er an der E-Mail gespeichert ist. Kann einen Anzeigenamen enthalten.

tostring

Empfängeradresse.

subjectstring

Betreffzeile.

statusstring

Immer canceled.

previous_statusstring

Status vor der Stornierung: scheduled, accepted oder attempted.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

timestampstring

Zeitpunkt der Stornierung der E-Mail, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.canceled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "status": "canceled",
    "previous_status": "scheduled",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "timestamp": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "status": "canceled",
      "previous_status": "scheduled",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "timestamp": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.complained

Wird gesendet, wenn ein Empfänger Ihre E-Mail als Spam markiert und sein Postfachanbieter dies über einen Feedback-Loop an Emailit meldet. Je nach Ihren Einstellungen für die automatische Sperrung legt Emailit für die Adresse eine Sperrung vom Typ complaint an. Siehe Bounces und Beschwerden.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.complained.

objectobject

Die E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…).

objectstring

Immer email.

fromstring

Absenderadresse ohne Anzeigenamen.

tostring

Empfängeradresse. Emailit erstellt für jeden Empfänger eine eigene E-Mail.

subjectstring | null

Betreffzeile.

statusstring

Immer complained.

metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

updated_atstring

Zeitpunkt der letzten Aktualisierung des E-Mail-Datensatzes vor diesem Event, im Format ISO 8601 mit UTC-Offset. Er kann vor der eigentlichen Statusänderung liegen.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.complained",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "complained",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "complained",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.received

Wird gesendet, wenn Emailit eine E-Mail an einer Ihrer Adressen für eingehende E-Mails empfängt. Der Payload enthält nur die Envelope-Daten: Inhalt und Anhänge rufen Sie mit E-Mail abrufen über die id ab.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.received.

objectobject

Die empfangene E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring

E-Mail-ID (em_…) der empfangenen E-Mail.

objectstring

Immer email.

fromstring

Absenderadresse aus dem Header From.

tostring

Inbound-Adresse, an der die E-Mail eingegangen ist.

subjectstring | null

Betreffzeile.

created_atstring

Zeitpunkt, zu dem Emailit die E-Mail empfangen hat, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.received",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "ada@example.com",
    "to": "support@inbound.acme.com",
    "subject": "Question about my order",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "ada@example.com",
      "to": "support@inbound.acme.com",
      "subject": "Question about my order",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.loaded

Wird jedes Mal gesendet, wenn das Tracking-Pixel in einer E-Mail lädt, was meist bedeutet, dass der Empfänger sie geöffnet hat. Öffnungs-Tracking erfordert eine verifizierte Tracking-Domain und für die E-Mail aktiviertes Öffnungs-Tracking. E-Mail-Clients, die Bilder vorab laden oder blockieren, machen Öffnungen zu einem Näherungswert.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.loaded.

objectobject

Die Öffnung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Ladevorgangs-Objekt

idstring

Öffnungs-ID (load_…).

objectstring

Immer load.

email_idstring

ID der E-Mail (em_…).

emailobject

Die E-Mail.

email.idstring

E-Mail-ID (em_…).

email.rcpt_tostring

Empfängeradresse.

email.mail_fromstring

Absender, wie er an der E-Mail gespeichert ist. Kann einen Anzeigenamen enthalten.

email.subjectstring | null

Betreffzeile.

email.created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

email.campaignobject | null

id und name der Kampagne, die die E-Mail gesendet hat, oder null bei E-Mails, die per API oder SMTP gesendet wurden.

email.metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

contactobject | null

id und email des Kontakts mit der Adresse des Empfängers in diesem Workspace oder null, wenn es keinen gibt.

ip_addressstring

IP-Adresse der Anfrage.

user_agentstring | null

User-Agent des Clients, der die Anfrage gestellt hat.

created_atstring

Zeitpunkt, zu dem das Pixel geladen wurde, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.loaded",
  "object": {
    "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
    "object": "load",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
      "object": "load",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.clicked

Wird jedes Mal gesendet, wenn jemand auf einen getrackten Link in einer E-Mail klickt. Klick-Tracking erfordert eine verifizierte Tracking-Domain und für die E-Mail aktiviertes Klick-Tracking. Emailit filtert keine automatisierten Klicks heraus, etwa Linkprüfungen durch Sicherheitsscanner.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.clicked.

objectobject

Der Klick, den das Event beschreibt. Seine Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Klick-Objekt

idstring

Klick-ID (click_…).

objectstring

Immer click.

email_idstring

ID der E-Mail (em_…).

emailobject

Die E-Mail.

email.idstring

E-Mail-ID (em_…).

email.rcpt_tostring

Empfängeradresse.

email.mail_fromstring

Absender, wie er an der E-Mail gespeichert ist. Kann einen Anzeigenamen enthalten.

email.subjectstring | null

Betreffzeile.

email.created_atstring

Zeitpunkt, zu dem Emailit die E-Mail angenommen hat.

email.campaignobject | null

id und name der Kampagne, die die E-Mail gesendet hat, oder null bei E-Mails, die per API oder SMTP gesendet wurden.

email.metaobject | null

Das mit der E-Mail gesendete Objekt meta oder null.

linkobject

Der angeklickte Link.

link.idstring

Link-ID (link_…).

link.urlstring

Ziel-URL.

contactobject | null

id und email des Kontakts mit der Adresse des Empfängers in diesem Workspace oder null, wenn es keinen gibt.

ip_addressstring

IP-Adresse der Anfrage.

user_agentstring | null

User-Agent des Clients, der die Anfrage gestellt hat.

created_atstring

Zeitpunkt des Klicks, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.clicked",
  "object": {
    "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
    "object": "click",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "link": {
      "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
      "url": "https://acme.com/blog/october-update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
      "object": "click",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "link": {
        "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
        "url": "https://acme.com/blog/october-update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.unsubscribed

Wird gesendet, wenn sich ein Kontakt von Ihren Kampagnen abmeldet, zum Beispiel über den Abmeldelink in einer Kampagnen-E-Mail. Emailit sendet außerdem subscriber.updated für jede Kontaktliste, die der Kontakt verlassen hat. Siehe Abmeldungen.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.unsubscribed.

objectobject

Die Kampagnen-E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring | null

ID (em_…) der Kampagnen-E-Mail, auf die der Kontakt reagiert hat, oder null, wenn Emailit keine zuordnen konnte.

objectstring

Immer email.

fromstring

Absender der Kampagnen-E-Mail.

tostring

Adresse des Kontakts.

subjectstring

Betreff der Kampagnen-E-Mail.

campaignobject | null

id und name der Kampagne oder null.

contactobject | null

id und email des Kontakts.

unsubscribed_atstring

Zeitpunkt der Abmeldung des Kontakts, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.unsubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.resubscribed

Wird gesendet, wenn ein Kontakt, der sich von Ihren Kampagnen abgemeldet hat, wieder angemeldet wird, zum Beispiel über die Option zur erneuten Anmeldung auf der Abmeldeseite. Emailit sendet außerdem subscriber.updated für jede Kontaktliste, der der Kontakt wieder beigetreten ist.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

typestring

Immer email.resubscribed.

objectobject

Die Kampagnen-E-Mail, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

E-Mail-Objekt

idstring | null

ID (em_…) der Kampagnen-E-Mail, auf die der Kontakt reagiert hat, oder null, wenn Emailit keine zuordnen konnte.

objectstring

Immer email.

fromstring

Absender der Kampagnen-E-Mail.

tostring

Adresse des Kontakts.

subjectstring

Betreff der Kampagnen-E-Mail.

campaignobject | null

id und name der Kampagne oder null.

contactobject | null

id und email des Kontakts.

resubscribed_atstring

Zeitpunkt der erneuten Anmeldung des Kontakts, im Format ISO 8601 mit UTC-Offset.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.resubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}