Emailit
Dokumentation Webhooks

Webhooks

Webhooks ermöglichen es Ihnen, HTTP-Benachrichtigungen in Echtzeit zu erhalten, wenn Ereignisse in Ihrem Emailit-Konto auftreten – beispielsweise wenn eine E-Mail zugestellt oder zurückgewiesen wird oder ein Kontakt erstellt wird.

Anstatt die API kontinuierlich nach Änderungen abzufragen, übertragen Webhooks Daten direkt an Ihren Server, sobald Ereignisse eintreten. So können Sie reaktive Integrationen und Arbeitsabläufe entwickeln.

Funktionsweise

  1. Sie erstellen einen Webhook-Endpunkt in Ihrer Anwendung, der POST-Anfragen entgegennimmt
  2. Sie registrieren die URL im Emailit-Dashboard oder über die API
  3. Wenn ein abonniertes Ereignis eintritt, sendet Emailit eine POST-Anfrage an Ihre URL mit den Ereignisdaten
  4. Ihr Endpunkt antwortet mit einem 2xx-Statuscode, um den Empfang zu bestätigen

Ereignisstruktur

Jedes Webhook-Ereignis folgt einer einheitlichen Struktur:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

FeldBeschreibung
event_idEindeutige Kennung für dieses Ereignis
typeDer Ereignistyp (z.B. email.delivered, contact.created)
data.objectDas mit dem Ereignis verknüpfte Ressourcenobjekt

Verfügbare Ereignisse

Emailit sendet Webhook-Benachrichtigungen für die folgenden Ressourcentypen:

  • E-Mails — Ereignisse des Zustellungslebenszyklus (akzeptiert, zugestellt, zurückgewiesen, etc.)
  • Domains — Domain-Erstellung, -Aktualisierungen und -Löschung
  • Zielgruppen — Ereignisse der Zielgruppenverwaltung
  • Abonnenten — Ereignisse des Abonnenten-Lebenszyklus
  • Kontakte — Ereignisse der Kontaktverwaltung
  • Vorlagen — Vorlagen-Erstellung, -Aktualisierungen und -Löschung
  • Unterdrückungen — Änderungen der Unterdrückungsliste
  • E-Mail-Verifizierungen — Verifizierungsergebnisse
  • E-Mail-Verifizierungslisten — Ereignisse von Massen-Verifizierungslisten

Die vollständige Liste finden Sie unter Ereignistypen.

Nächste Schritte

NextEreignistypen
Lokalisiert durch KI