Build apps
Developer platform
Learn how to create apps on the new developer platform
Last modified: August 22, 2025
HubSpot’s new developer platform, 2025.2, provides multiple advantages over legacy private and public apps, including a new file-based build-and-deploy framework. This framework contains an app’s configuration, assets, and other source code.
Create an app
The app creation guide walks you through how to get up and running with a proof-of-concept app that uses a boilerplate example project and schema definition. You can then upload the associated configuration files to a project in your developer account, and test out an install using a developer test account.The app creation article linked above provides a full setup guide to customize and deploy a new app using the
hs project create command.If you’re new to building apps on HubSpot, check out the quickstart guide that will get you up and running with a demo app using the streamlined hs get-started command.Migration guides
If you have an existing app built using a project on the old version of the developer platform, you can migrate the app to the new version of the platform by following one of the guides below:App configuration
Whether you’re starting from scratch with the quickstart guide, creating an app using the full setup guide, or migrating an existing legacy app, you can consult the app configuration reference article for details on all available fields in your app’s top-levelapp-hsmeta.json schema file.
Features
Once you’ve got your new app up and running, you can add features such as app cards and webhooks. The features available to an app depend on the app’s distribution and authentication configuration, as shown in the table below.Legacy apps
During this beta, all existing developer account tools are accessible in the Development left sidebar navigation menu. To review any previously created private or public apps, you can click Legacy Apps.