Skip to main content

HubSpot developer projects include a platformVersion field that enables you to control which version of the projects platform you're developing on. This enables you to access updated functionalities, rollback to previous versions, and generally coordinate changes as needed.

Below, learn how to set the platformVersion in a project, along with the available versions and their updates.

To set which version of the developer platform your projects are running on, use the platformVersion field in your project's hsproject.json file.

After changing the version number, you'll need to upload the project to the HubSpot account to enable access to the version updates.

  • Latest version: 2023.2 (November 21, 2023)
  • Initial release: 2023.1 (sunset as of March 31, 2024)
ParameterDescription
2023.2Available as of November 21, 2023.Changes primarily impact app functions, including:
  • Support for asynchronous functions (async / await)
  • Public URL support for app functions
  • PRIVATE_APP_ACCESS_TOKEN moved from context.secrets to process.env
  • Increased log size from 4KB to 256KB with logs now in order of execution
  • Support for Node 18
Learn more about working with these changes below.
2023.1SunsetInitial release of the developer platform.This version is no longer be available as of March 31, 2024. Attempts to upload projects at this version will fail.

Version 2023.2 of the developer platform includes the changes below.

The following changes have been made for serverless function configuration (serverless.json):

  • Previously, serverless functions in projects supported two types of functions: app and API endpoint. App functions have been updated to support public URLs for making API requests, so you no longer need to build these as separate types.
  • With this update, the runtime and version fields have also been removed.
  • This version uses Node18, and lower versions cannot be specified.

Previous serverless function configuration

Updated serverless function configuration

Projects now support asynchronous functions. Callbacks are no longer supported in this version.

To update your serverless functions to use async:

  • Add async to the function definition.
  • Remove the callback (sometimes referred to as sendResponse), and use return statements to return response.
  • Use await and try/catch instead of promise chaining.
  • Return the desired response or throw an error.

Whereas previously you would refer to private app access tokens with context.secrets.PRIVATE_APP_ACCESS_TOKEN, you'll now use process.env rather than context.secrets. For example:

Version 2023.2 increases log size from 4KB to 256KB and guarantees logs to be in order of execution. You can also take advantage of improved in-app logging, such as log tracing.