Webhooks

Webhooks senden Events in dem Moment an deinen Endpoint, in dem sie passieren – ohne Polling. Einmal abonnieren, auf Änderungen im gesamten Bestand reagieren.

Was du abonnieren kannst

Der Event-Katalog wächst mit der Plattform. Statt einer festen Liste, die veraltet, frag die aktuellen Event-Typen über die API ab:

• GET /propertymanagement/v2/query/webhooks.eventTypes – die aktuelle Liste der Event-Typen, maschinenlesbar.

Webhooks decken Anlegen-, Ändern- und Löschen-Events über die zentralen Entitätstypen ab, darunter Objekte, Einheiten und Kontakte.

Einrichtung

Webhooks werden pro Tenant konfiguriert, entweder in der etg24-App oder über die API:

• POST /propertymanagement/v2/command/webhooks.create – einen Webhook mit Name, URL und den zu abonnierenden Events anlegen.
• Auflisten, Anzeigen und Löschen deiner Webhooks über die weiteren Endpoints in der Property-Management-v2-Referenz.

Jeder Webhook kann einen Authorization-Header tragen, der bei jeder Zustellung mitgesendet wird – so kann dein Endpoint prüfen, dass die Anfrage wirklich von deinem Webhook stammt.

Zustellung

Tritt ein abonniertes Event ein, wird das Event-Payload direkt an deinen Webhook-Endpoint weitergeleitet:

• Events werden als JSON-POST-Requests an deine konfigurierte URL zugestellt.
• Das Payload enthält die Event-Daten der geänderten Entität.
• Dein Authorization-Header wird, falls konfiguriert, an jede Zustellung angehängt.

Typische Muster

• Zwei-Wege-Synchronisation – Kontaktänderungen sofort in dein CRM schieben, wenn sie passieren.
• Einheiten-Verfügbarkeit – dein Listingsystem aktualisieren, wenn eine Einheit angelegt, geändert oder gelöscht wird.
• Watchdog-Automatisierungen – dein Team bei Objektänderungen alarmieren, ohne die API zu pollen.

Webhooks passen natürlich zu CQRS: Events sind die Benachrichtigungsschicht, Commands und Queries bleiben deine Handlungsschicht.