Pipelines API V1 Sunset: Migration bis Dezember 2026

HubSpot deaktiviert die Pipelines API V1 am 4. Dezember 2026 endgültig. Ab diesem Datum akzeptiert HubSpot keine Aufrufe mehr über die alten V1-Endpunkte der Pipelines API. Wer Pipelines, Pipeline-Stages oder zugehörige Objekte über diese Version verwaltet, muss vor dem Stichtag auf die Version 2026-03 oder neuer migrieren. Sonst brechen betroffene Integrationen ohne Vorwarnung ab.

Was am 4. Dezember 2026 konkret passiert

Laut dem offiziellen HubSpot Changelog wird die Pipelines API V1 an diesem Tag nicht gedrosselt oder eingeschränkt, sondern vollständig abgeschaltet. Anfragen an V1-Endpunkte laufen danach ins Leere, es gibt keine Übergangsfrist und keine automatische Weiterleitung auf eine neuere Version. Für Unternehmen, die HubSpot über eigene Integrationen, Middleware oder Custom-Code-Actions ansteuern, bedeutet das: Jeder Aufruf, der noch die alte Pfadstruktur oder das alte Antwortformat der V1-Pipelines-Endpunkte nutzt, muss vorher umgestellt sein.

Betroffen sind typischerweise Integrationen, die vor 2023 oder 2024 gebaut wurden, oft von Agenturen oder internen Entwicklern, die inzwischen nicht mehr im Unternehmen sind. Genau das macht diesen Sunset in der Praxis unangenehmer, als die reine technische Beschreibung vermuten lässt.

Warum die Pipelines API in vielen Systemen eine zentrale Rolle spielt

Pipelines sind in HubSpot die strukturelle Grundlage für Deals, Tickets und teilweise auch für individuelle Objekte. Wer Pipelines und Stages nicht manuell im Portal, sondern automatisiert über die API anlegt, etwa im Rahmen von Mandanten-Onboarding, Multi-Pipeline-Setups für unterschiedliche Geschäftsbereiche oder der Synchronisation mit einem ERP-System, arbeitet mit genau den Endpunkten, die jetzt betroffen sind.

Das betrifft unter anderem:

• Skripte, die bei neuen Mandanten oder Business Units automatisch passende Deal-Pipelines samt Stages anlegen
• Middleware, die Pipeline-Konfigurationen aus einem Quellsystem, etwa Salesforce oder einem ERP, nach HubSpot spiegelt
• Reporting-Tools oder BI-Anbindungen, die Pipeline-Metadaten regelmäßig auslesen, um Stage-Namen und -Reihenfolgen korrekt darzustellen
• Interne Admin-Tools, mit denen Ops-Teams Pipelines ohne HubSpot-Login pflegen

In allen diesen Fällen läuft der Betrieb nach dem 4. Dezember 2026 zunächst weiter, solange niemand etwas an der Pipeline-Struktur ändern oder auslesen muss. Genau in diesem Moment, oft mitten im Tagesgeschäft, fällt der Fehler dann auf.

Migration auf Version 2026-03: der eigentliche Aufwand

Die Migration selbst ist in den meisten Fällen kein grundlegender Umbau, aber auch kein reines Suchen-und-Ersetzen. Version 2026-03 unterscheidet sich von V1 unter anderem bei:

• der URL-Struktur der Endpunkte
• dem Aufbau der Response-Objekte, etwa bei verschachtelten Stage-Eigenschaften
• der Authentifizierung, sofern die Integration noch über ältere API-Key-Mechanismen statt über Private Apps läuft

Wer seine Private-App-Struktur ohnehin schon im Zuge anderer Sunsets angepasst hat, etwa im Rahmen der Abschaltung der Legacy Private Apps, hat bei diesem Schritt einen Teil der Arbeit bereits erledigt. Wer noch auf alten API-Keys oder unversionierten Aufrufen arbeitet, sollte die Migration nicht isoliert betrachten, sondern im Zusammenhang mit der generellen Abschaltung alter HubSpot-APIs bis September 2027 einordnen. Die Pipelines API V1 ist dabei nur ein Baustein von mehreren, die in den kommenden Monaten fällig werden.

Was bei Nichthandeln passiert

Der Ausfall betrifft nicht die Pipelines selbst. Bestehende Deals und Stages bleiben im CRM erhalten und funktionieren im Tagesgeschäft normal weiter. Was bricht, sind die programmatischen Zugriffe: Neue Pipelines lassen sich nicht mehr automatisiert anlegen, Änderungen an Stages über die API schlagen fehl, und Systeme, die Pipeline-Metadaten regelmäßig abrufen, erhalten ab dem Stichtag Fehlermeldungen statt Daten.

Für Unternehmen mit gewachsenen, oft historisch schlecht dokumentierten Integrationslandschaften ist die eigentliche Herausforderung selten die technische Umsetzung der Migration, sondern das Auffinden aller betroffenen Stellen. Wer nicht genau weiß, welche Skripte, Workflows oder internen Tools überhaupt noch V1-Endpunkte ansprechen, sollte vor dem 4. Dezember 2026 eine Bestandsaufnahme aller HubSpot-Integrationen machen, nicht erst danach.

Einordnung: HubSpot strafft seine API-Versionierung weiter

Der Sunset der Pipelines API V1 reiht sich in eine Reihe ähnlicher Schritte ein, mit denen HubSpot seine API-Landschaft in den vergangenen Jahren konsolidiert hat. Für Unternehmen, die HubSpot nicht nur als Oberfläche, sondern als Teil einer größeren Systemarchitektur nutzen, etwa im Zusammenspiel mit ERP, Data Warehouse oder anderen CRM-Systemen, wird die Wartung dieser Integrationen damit zu einer wiederkehrenden Aufgabe. Wer Pipeline-Daten aus mehreren Quellen zusammenführt, sollte diesen Anlass auch nutzen, um zu prüfen, wo im eigenen Setup tatsächlich die führende Datenquelle liegt und wo lediglich Kopien synchronisiert werden. Das ist ein Punkt, der oft unterschätzt wird, wie sich auch bei der Diskussion um eine Single Source of Truth im CRM zeigt.

Praktisch bedeutet das: API-Versionierung ist kein einmaliges Projekt, sondern ein fester Posten im Betrieb jeder HubSpot-Integration. Wer dafür keine internen Kapazitäten hat, sollte diese Aufgabe klar jemandem zuweisen, intern oder extern, statt sie bei jedem Sunset neu zu improvisieren.

Häufig gestellte Fragen

Was passiert mit bestehenden Pipelines nach dem 4. Dezember 2026?

Bestehende Pipelines, Stages und Deals bleiben im HubSpot-Portal erhalten und funktionieren in der Benutzeroberfläche normal weiter. Betroffen ist ausschließlich der programmatische Zugriff über die V1-Endpunkte der Pipelines API.

Reicht es, die API-Version im Code auszutauschen?

In den meisten Fällen nicht ohne Weiteres. Version 2026-03 unterscheidet sich von V1 bei der URL-Struktur, teilweise bei den Response-Objekten und bei der Authentifizierung. Ein reiner Versionswechsel ohne Anpassung des Codes führt häufig zu neuen Fehlern statt zu einer funktionierenden Migration.

Woran erkenne ich, ob eine Integration betroffen ist?

Ein Blick in die verwendeten Endpunkt-Pfade zeigt, ob eine Integration noch V1-Pfade der Pipelines API anspricht. Bei extern gebauten Integrationen, etwa durch Agenturen oder ehemalige Entwickler, lohnt sich vor dem Stichtag eine vollständige Bestandsaufnahme aller HubSpot-Anbindungen.

Gibt es eine Übergangsfrist nach dem Sunset-Datum?

Nein. Laut HubSpot wird die Pipelines API V1 am 4. Dezember 2026 vollständig abgeschaltet, ohne Kulanzfrist oder automatische Weiterleitung auf eine neuere Version.