Upgrade custom code actions to Node.js 24

​

Prerequisites

• You must have permission to edit workflows in your HubSpot account.
• It’s recommended to create a dedicated test record (for example, a test contact) to test your updated actions. Testing a custom code action applies its changes to the selected record.

​

Find affected custom code actions

1. In your HubSpot account, navigate to Automation > Workflows.
2. At the top of the table, add an Action type filter, then select Custom code.

3. Each workflow needs to be updated individually. For each workflow in the filtered list, hover over the row and click Edit workflow.

4. In the workflow editor, click each custom code action and check the Language dropdown menu. If the action uses Node.js 16 or Node.js 20, it needs to be upgraded.

​

Save a copy of your current code

​

Upgrade with Breeze (recommended)

1. In the workflow editor, click a custom code action that uses Node.js 16 or 20. A warning appears under the Language dropdown menu.
2. Click Upgrade with Breeze. A Breeze chat opens and updates all custom code actions in the workflow to Node.js 24.

1. In the workflow editor, click the Collaborate with Assistant icon in the collaboration panel on the right to open a new Breeze chat.

2. Ask Breeze to update the actions, for example: Update all of the custom code actions that are using Node 16 or 20 to Node 24.

• Compare the updated code with your saved copy and check that the logic is the same.
• Check that every output in your Data outputs section is still returned.
• Check that any API calls still use methods that exist in the new library versions.
• Test each updated action with a test record.

​

Upgrade manually

1. In the workflow editor, click the custom code action.
2. Click the Language dropdown menu, then select Node.js 24.x.
3. Update your code:
   • Remove the callback parameter from exports.main.
   • Make sure exports.main is an async function.
   • Replace each callback({ outputFields: { ... } }) call with return { outputFields: { ... } };.
   • Use await for any asynchronous work, such as API calls, before you return. Code that’s still running after return isn’t guaranteed to finish.
4. Check the libraries your code uses against the library changes below.
5. Test the action before you save.

​

Before and after

exports.main = async (event, callback) => {
  const email = event.inputFields['email'];

  callback({
    outputFields: {
      email: email
    }
  });
}

exports.main = async (event) => {
  const email = event.inputFields['email'];

  return {
    outputFields: {
      email: email
    }
  };
}

​

Errors and retries

​

Check library and SDK changes

• HubSpot API client: Node.js 24 includes version 13 of @hubspot/api-client. Node.js 20 included version 11, and Node.js 16 included version 10. Review the HubSpot Node.js client release notes for changes to the methods your code calls.
• request: the request library isn’t available in Node.js 24. Use axios or the built-in fetch() function instead.
• mongoose, redis, and googleapis: each has a new major version in Node.js 24. Review each library’s release notes if your code uses it.

​

Test each updated action

1. In the workflow editor, click the custom code action.
2. At the bottom, click Test action to expand the testing section.
3. Click the Object dropdown menu, then select your test record.
4. Click Test, then confirm in the dialog box.
5. Review the results:
   • Status: confirm the action succeeded.
   • Data outputs: confirm each output has the value you expect.
   • Logs: check for errors, such as a missing library or a method that no longer exists.
6. When the test passes, click Save.

​

Roll back an upgrade

1. In the workflow editor, click the custom code action.
2. Click the Language dropdown menu, then select Node.js 20.x.
3. Replace the code with your saved copy.
4. Test the action, then click Save.

​

Deadline

• Starting November 3, 2026, you can’t create new custom code actions that use Node.js 20.
• Starting November 17, 2026, you can’t save changes to existing custom code actions that use Node.js 20, the same way Node.js 16 works today.

​

Related resources

• Custom code actions
• HubSpot Node.js client