HubSpot Custom Code Actions: Node.js 20 nicht mehr editierbar. So stellst du auf Node.js 24 um
Seit 17. November 2026 kannst du HubSpot Custom Code Actions mit Node.js 20 nicht mehr speichern, sie laufen aber weiter. Für die Umstellung auf Node.js 24 musst du den Callback durch return ersetzen und Methoden des HubSpot-Clients prüfen, der von Version 11 auf 13 springt. Wer nicht umstellt, kann die Aktion bei einem Fehler nur noch reparieren, indem er sie komplett umbaut.
Was gilt seit 17. November?
Seit Dienstag, 17. November 2026, kannst du HubSpot Custom Code Actions mit Node.js 20 nicht mehr speichern. Sie laufen weiter, aber jede Korrektur am Code ist gesperrt, bis du die Aktion auf Node.js 24 umstellst. So steht es im HubSpot Developer Changelog vom 3. November. Seit diesem Tag lassen sich auch keine neuen Node-20-Aktionen mehr anlegen, dafür steht Node.js 24 zur Auswahl.
Custom Code Actions sind Workflow-Schritte, in denen eigenes JavaScript läuft, etwa um Daten zu formatieren, Werte zu berechnen oder eine fremde API abzufragen. Sie gibt es laut HubSpot-Doku nur mit Data Hub Professional oder Enterprise. Der Grund für die Frist: Node.js 16 und 20 bekommen keine Sicherheitsupdates mehr, nodejs.org führt Node.js 20 als End-of-Life. Aktionen mit Node.js 16 lassen sich schon heute nur speichern, wenn du sie auf eine neuere Version stellst.
| Datum | Was passiert |
|---|---|
| 3. November 2026 | Keine neuen Node-20-Aktionen, Node.js 24 verfügbar |
| 17. November 2026 | Node-20-Aktionen nicht mehr speicherbar, der Rückweg auf Node.js 20 endet |
| 1. Februar 2027 | Serverless Functions aus dem Design Manager (Website) laufen nicht mehr |
Warum ist die Bearbeitungssperre gefährlicher als eine Abschaltung?
Weil sie erst auffällt, wenn du etwas ändern musst, und dann meist unter Zeitdruck. Ein Beispiel aus dem Kalender: Am 4. Dezember schaltet HubSpot die Pipelines API V1 ab. Ruft eine Node-20-Aktion diese Schnittstelle noch auf, musst du den Aufruf ändern. Das geht dann nur, indem du die ganze Aktion auf Node.js 24 hebst, mit allen Bibliotheksänderungen von unten. Ob Node-20-Aktionen irgendwann ganz stoppen, sagt HubSpot bisher nicht. Auch der Community-Thread zur Ankündigung enthält dazu keine Aussage.
Wie findest du betroffene Aktionen?
Über den Filter in der Workflow-Liste, Portal für Portal:
- Automation > Workflows öffnen.
- Filter Action type auf Custom code setzen.
- Jeden Workflow öffnen, jede Code-Aktion anklicken und im Dropdown Language nachsehen. Steht dort Node.js 16 oder 20, muss sie umgestellt werden.
- Den Code jeder Aktion vorher außerhalb von HubSpot sichern. Der Upgrade-Guide empfiehlt das ausdrücklich, sonst hast du nichts zum Vergleichen und Zurückrollen.
Was musst du am Code ändern?
Drei Dinge: den Callback ersetzen, den HubSpot-Client prüfen, alte Bibliotheken tauschen.
1. Return statt Callback. Node.js 24 akzeptiert nur async-Funktionen ohne Callback. Aus dem Aufruf callback({ outputFields: { ... } }) wird return { outputFields: { ... } };, und aus exports.main = async (event, callback) wird exports.main = async (event). Alles Asynchrone muss vorher mit await fertig sein: Code, der nach dem return noch läuft, wird laut Guide nicht garantiert zu Ende ausgeführt. Unsere Einschätzung: Genau hier verstecken sich die Fehler, die im Test nicht auffallen. Such gezielt nach Promise-Ketten mit .then() ohne await.
2. HubSpot-Client von Version 11 auf 13. Unter Node.js 20 läuft @hubspot/api-client in Version 11, unter Node.js 24 in Version 13.4.0. Dazwischen liegen zwei Major-Versionen mit Umbenennungen, nachzulesen im Changelog des Clients. Was in Workflows typischerweise vorkommt:
merge()für Kontakte, Firmen, Deals und Tickets liegt jetzt inbasicApi. Der frühere OrtpublicObjectApiwurde in 12.0 umbenannt und in 13.0 entfernt.- Listen-IDs (
listId,listIds) sind Strings statt Zahlen. purge()für Kontakte (DSGVO-Löschung) liegt incrm.contacts.basicApi, derGDPRApiist weg.- Bei den Association-Definitionen (v4) heißt
archive()jetztremove().
3. Weitere Bibliotheken. request ist unter Node.js 24 nicht mehr enthalten, Ersatz ist axios (jetzt Version 1.13.5) oder das eingebaute fetch(). Größere Sprünge machen mongoose (6 auf 9), redis (4 auf 5) und googleapis (67 auf 171). Neu dabei ist aws-sdk.
Kann Breeze das für dich erledigen?
Teilweise. Breeze, HubSpots eingebauter KI-Assistent, bietet unter dem Language-Dropdown Upgrade with Breeze an und stellt dann alle Code-Aktionen eines Workflows um. HubSpot schreibt selbst, dass Breeze Fehler machen kann. Im Community-Thread meldet ein Kunde eine Fehlermeldung beim Breeze-Upgrade. Unsere Einschätzung: Für den Umbau von Callback auf Return ist Breeze brauchbar, die Methodennamen im HubSpot-Client prüfst du trotzdem selbst. Kontrolliere danach, dass jede Aktion alle Data outputs weiter zurückgibt: Die folgenden Workflow-Schritte lesen genau diese Werte. Die HubSpot CLI hilft hier nicht, sie kann Custom Code Actions nicht aktualisieren.
Wie testest du, ohne Kundendaten zu verändern?
Mit einem eigenen Testdatensatz. Der Test unter Test action führt die Aktion wirklich aus und wendet ihre Änderungen auf den gewählten Datensatz an. Leg also einen Testkontakt oder Testdeal an. Schickt die Aktion Daten an ein anderes System, kommt auch der Testlauf dort an. Getestet wird nur die Aktion, nicht der ganze Workflow. Prüfe Status, Data outputs und Logs, erst dann speichern.
Einen Rückweg auf Node.js 20 gibt es seit 17. November nicht mehr: Eine Aktion mit Node.js 20 lässt sich nicht speichern, also auch nicht zurückrollen. Bei Node.js 16 ging das ohnehin nie. Klemmt eine umgestellte Aktion, behebst du den Fehler unter Node.js 24.
Umstellen oder nach Make und n8n verlagern?
Die Umstellung ist ein guter Anlass, jede Aktion einmal zu hinterfragen. Custom Code in HubSpot hat harte Grenzen: 20 Sekunden Laufzeit, 128 MB Arbeitsspeicher, alle Secrets zusammen höchstens 1.000 Zeichen. Dafür hat er einen Vorteil: Wirft dein Code einen Rate-Limit-Fehler weiter, wiederholt HubSpot die Aktion bis zu drei Tage lang von selbst.
| Situation | Unsere Empfehlung |
|---|---|
| Kurze Formatierung, Berechnung, ein API-Aufruf | In HubSpot lassen, auf Node.js 24 umstellen |
| Mehrere Systeme, lange Laufzeit, große Datenmengen | Logik nach Make oder n8n verlagern, HubSpot liefert nur den Anstoß |
| Niemand weiß mehr genau, was die Aktion tut | Erst dokumentieren, dann entscheiden |
| Workflow ist inaktiv oder wird kaum ausgelöst | Prüfen, ob die Aktion ganz wegfallen kann |
Was Make und n8n im Betrieb kosten, haben wir in Make oder n8n? durchgerechnet.
Was heißt das für dich?
- Jetzt: Inventur in jedem Portal. Seit 17. November lassen sich Node-20-Aktionen nicht mehr speichern. Jede, die du noch ändern willst, musst du auf Node.js 24 umstellen. Bleibt eine Aktion auf Node.js 20, heißt das: Du kannst sie bei einem Fehler nicht reparieren, ohne sie erst komplett umzustellen, und sie läuft auf einer Version ohne Sicherheitsupdates.
- Zuerst dran: Aktionen, die abgekündigte HubSpot-Schnittstellen nutzen (Pipelines V1 am 4. Dezember), und Aktionen mit
request. - Website auf HubSpot CMS: Serverless Functions aus dem Design Manager (Adressen unter
/_hcms/api/) sind seit 17. November ebenfalls nicht mehr bearbeitbar und laufen ab 1. Februar 2027 nicht mehr. Sie müssen in Developer Projects umziehen und sind dann unter/hs/serverless/erreichbar. Jede Seite, jedes Modul und jede Einstellung, die sie aufruft, braucht die neue Adresse. - Gleich mitnehmen: Wer gerade ohnehin Private Apps auf die neuen Schlüssel umstellt, sollte die Code-Aktionen im selben Durchgang prüfen.
Du willst die Inventur nicht selbst machen? Wir stellen deine HubSpot-Workflows auf Node.js 24 um oder verlagern die Logik nach Make oder n8n, wenn sie dort besser aufgehoben ist. Wie wir mit n8n arbeiten, zeigt unsere Seite n8n-Agentur. Schick uns kurz, welche Aktionen bei dir betroffen sind: Anfrage stellen.
Häufige Fragen
Kann ich statt Node.js 24 auch Python nehmen?
Python gibt es für Custom Code Actions nur als Beta. HubSpot nennt im Upgrade-Guide Node.js 24 als Ziel; für produktive Workflows ist das der sichere Weg.
Wie genau wiederholt HubSpot eine Aktion nach einem Rate-Limit-Fehler?
Wenn dein Code den Fehler im catch-Block weiterwirft, startet der erste neue Versuch eine Minute später. Danach versucht HubSpot es bis zu drei Tage lang, mit höchstens acht Stunden Abstand zwischen zwei Versuchen.
Wie viele Werte darf eine Custom Code Action zurückgeben?
Eine feste Höchstzahl an Ausgabefeldern nennt HubSpot nicht. Texte in Ausgabewerten dürfen bis zu 65.000 Zeichen lang sein, und je Aktion lassen sich bis zu 50 HubSpot-Properties einbinden.
Was ist, wenn Node.js 20.x im Language-Dropdown fehlt?
Dann ist kein Rückweg auf Node.js 20 möglich. Die Aktion muss auf Node.js 24 funktionieren, also Fehler dort beheben statt zurückrollen.
Quellen
Schreib uns, was du vorhast. Innerhalb von 24 Stunden bekommst du eine ehrliche Einschätzung.
Weitere Artikel