HubSpot hält CRM-Ereignisse im Webhooks-Journal bereit

HubSpot bietet ein Webhooks-Journal an, über das Anbindungen vergangene CRM-Ereignisse abrufen können. Der Journalzugriff reicht bis zu drei Tage zurück. Die Dokumentation zum Webhooks-Journal und den Verwaltungs-APIs (Stand 3. Oktober 2026) beschreibt das Angebot als Beta. Die neuen Abonnements werden in ein Journal geschrieben, das die App abfragt.

Die App liest Ereignisse über einen Offset#

Für den Zugriff stehen Endpunkte für den frühesten und den neuesten Journaleintrag sowie für den nächsten Eintrag nach einem bestimmten Offset bereit. Die Antworten enthalten die Adresse einer Journaldatei. Eine Anbindung kann dort die Ereignisdaten abrufen und anschließend anhand des Offsets weiterarbeiten.

Die Verwaltung beschreibt Abonnements für bestimmte Objekttypen, Aktionen und Eigenschaften. Dazu gehören unter anderem das Erstellen, Ändern, Löschen und Zusammenführen von CRM-Objekten sowie das Hinzufügen oder Entfernen von Zuordnungen. Eine Vertriebsanbindung kann damit festlegen, welche Veränderungen für ihren Ablauf relevant sind.

Rechte für Journal und CRM-Objekte#

Die Endpunkte verlangen OAuth-Authentifizierung und eigene Scopes für Journalzugriff, Abonnements und Snapshots. Zusätzlich sind die Rechte für die betreffenden CRM-Objekttypen erforderlich. Für Kontaktänderungen nennt HubSpot beispielsweise den Kontaktscope.

Das Journal beschreibt die Veränderungen in zeitlicher Reihenfolge. Im Unterschied zum bisherigen Webhooks-Modell enthalten die neuen Abonnementendpunkte kein targetUrl: Die App liest aus dem Journal. Das dreitägige Abruffenster verbindet die aktuelle Verarbeitung mit der Möglichkeit, jüngere Ereignisse nachträglich abzuholen.