HubSpot Developer Platform

What is it?

The HubSpot Developer Platform is a unified app framework that gives you a modern and consistent way to build on HubSpot, with tools that meet you where you are. Equipped with a growing set of developer tools, a reimagined developer experience, and deeper extensibility, you can confidently create, scalable, AI-ready apps and solutions that are built to grow alongside you.

Developer Platform highlights:

• New extensibility capabilities: App Settings, App Home, App Objects, App Events, and Agent Tools.
• Unified app framework: Replaces private and public apps with a single model. You can configure authentication (static or OAuth) and distribution (Private or Marketplace) to fit your use case.
• Modernized development experience: Project-based development with local workflows, designed for consistency and productivity, refined through two years of real app building in public beta.
• AI-native documentation that helps you find what you need faster
• Streamlined HubSpot pipeline: Enables faster delivery of new developer capabilities.
• Developer MCP server (local): Installed via the HubSpot CLI to help you build, test, and deploy integrations more intelligently.
• HubSpot MCP server (remote): Provides a hosted endpoint that brings HubSpot context into the tools and environments where you work.

Moving forward, all new app capabilities and developer tooling improvements will be made exclusively on the HubSpot Developer Platform.

Why does it matter?

The future of business software is not about choosing between different tools; it is about creating seamless, intelligent experiences that adapt to how teams actually work. Today, we are taking a major step toward making that vision a reality.

The HubSpot Developer Platform is the path forward and signals HubSpot’s commitment to investing in the developer community. Customers want deeper, more feature-rich integrations delivered faster, and this platform makes it possible to meet that demand.

By unifying the developer experience, HubSpot can deliver new capabilities more quickly while giving developers modern tools to build better solutions with greater speed and impact. Starting today, there is one way to build on HubSpot—whether you are creating a custom integration or the next great Marketplace app.

The unified experience combines a central developer overview, a consistent development framework, AI-native documentation, and CLI-guided setup flows (including the new hs get-started command) to take you from idea to “hello world” in minutes. It also enables deeper, more feature-rich integrations to solve customer pain points. Unification is not just about convenience; it is about unlocking new possibilities for developers and customers alike.

How does it work?

Accessing the Developer Platform

Existing developer accounts must opt in through a CTA on the Developer Home page. After opting in, your account will be converted to a HubSpot free account with development tools moved under the Development Navigation. Customer accounts automatically receive the new Developer Platform in the Development Navigation.

Please note: access to the new Developer Platform does not impact your existing private and public apps. Apps can be migrated individually.

Managing Existing Apps

Once your account is upgraded, you can find your existing private and public apps in Development > Legacy Apps. These apps continue to work and can still be configured using legacy tools.

• Each app must be migrated individually to the new Developer Platform.
• HubSpot will provide advance notice before deprecation dates. You can build new project-based Developer Platform apps alongside existing legacy apps.

New Capabilities

• App Objects: Marketplace-distributed apps can centrally define app-specific object models in their app config. HubSpot manages setup and updates across all installs. Object schemas are protected from customer edits, work across the platform, and are accessible to all tiers.
• App Events: Timeline Events are now App Events, with support for Reporting and User Management for Marketplace-distributed apps.
• App Settings: Create rich, interactive configuration screens within Connected Apps using React-based UI Extensions.
• App Home: A fully customizable page where your app can deliver account-level value.
• Agent Tools: Expose key app actions in Breeze Studio, allowing users to build custom agents that include your app’s functionality.
• App Cards: Previously in public beta, React-based App Cards powered by hubspot.fetch() are now generally available for private or Marketplace distribution.

Modern Developer Tools

• Development navigation accessible to all Admins and users with a free Developer Seat.
• Free CRM features to support app growth.
• Declarative, file-based app configuration.
• Developer Overview: A dynamic dashboard of content and tools.
• AI-native Developer Docs, including an AI Assistant and updated Information Architecture.
• Developer Profiles: Configure a single project for multiple environments (DEV, QA, PROD).
• Configurable Developer Test Accounts: Test apps with any hub/tier combination.
• Streamlined projects and app management.
• Streamlined local development in the CLI.
• Auditable app updates with rollback support.
• GitHub Action templates for CI/CD integration.
• Updated project structure and schema for improved usability.

Simplified App Distribution

Distribution is no longer determined by whether an app is “Private” or “Public.” Developers can build an app once and configure it for private distribution (across one or more accounts) or Marketplace distribution (for all accounts). You can also start with a privately distributed app and later change it to Marketplace distribution without rebuilding. This flexibility reduces the need to publish to the Marketplace for private use cases.

Unsupported Legacy Capabilities

Some legacy features are no longer supported. Legacy App Settings have been replaced with new React-based App Settings, which require manual migration. Serverless Functions for UI Extensions in Private Apps are not yet supported. A future update will add serverless support, but for now, developers can either delay upgrading or re-implement serverless functions as a separate OAuth backend.

CRM Development Transition

Two years ago, HubSpot introduced CRM Development with React-based App Cards powered by Serverless App Functions in public beta. With this release, React-based App Cards for private distribution are generally available, though serverless support is not included. Developers can use hubspot.fetch() to connect App Cards directly to their own backend servers. Those who require serverless functionality will need to opt in to the CRM Development beta and build a legacy private app.

Who gets it?

The new HubSpot Developer Platform is available to all hubs and tiers. You can learn more about transitioning to the new Developer Platform here.