Node.js v18 will reach end of life on April 30th, 2025. To make sure HubSpot systems stay up to date on security and reliability, we will be ending support for Node.js v18 on Oct 1, 2025. After this date, any existing functions using v18 will continue to operate, but you will need to upgrade to a supported version to continue to deploy changes. Any net new functions created must be using Node.js 20 or higher. If you're using Node for any of the serverless function systems, we encourage you to update your code before this time to ensure they are on the latest supported version. These systems include:

• CMS Serverless Functions
• Serverless and endpoint functions in Developer Projects
• HubSpot CLI

Custom Coded Workflow Actions are not affected because they previously upgraded directly to Node v20.

CMS Serverless functions

CMS serverless functions will continue to support Node.js v20. We recommend updating to nodejs20.x if you haven't already done so to ensure you get the longest support period. The Node version is declared in the serverless.json file.

If your functions are running Node.js v18, you should update them before Oct 1, 2025. Existing functions will continue to operate, but you will be required to upgrade to a newer version to deploy any changes to those functions.

Functions in Developer Projects

The Node version in serverless and endpoint functions in developer projects is dictated by the projects version in your project config. 

Version 2025.1 uses Node.js v20. Upgrade your project by updating the version number to 2025.1.

It is recommended that you test your functions to ensure they're working as expected before deploying the change to your production account.

You will need to be on HubSpot CLI version 7.2.0 or higher to update your project.

More information on Projects Platform Versioning.

HubSpot CLI

The HubSpot CLI currently supports v18 as it's minimum version. After Oct 1, 2025 all new versions of the CLI will require Node.js v20 or higher. If you are on an older version it should continue to operate, but be mindful old versions may have functionality that stops working, be missing newer features, and will not have as useful of error messaging and other helpful features.

To update to the latest version of the HubSpot CLI use npm install -g @hubspot/cli@latest in your terminal.

When is this happening?

Support for Node.js v18 will end on Oct 1, 2025 for all systems. After this, existing functions will continue to operate, but you will not be able to deploy any changes without updating to a newer version of Node.

Questions or comments? Join us in the developer forums.