Skip to main content Skip to footer

HubSpot Developer Changelog

September 2025 Developer Rollup

In September 2025, HubSpot rolled out a series of impactful developer updates, alongside those already announced during Inbound for the Developer Platform and API updates. Additional changes this month include a new Tooltip component and the addition of textTransform options, which improve UI consistency and guidance. Developers gained powerful new app card hooks—useCrmProperties and useAssociations—for streamlined access to CRM data. HubSpot CLI v7.7.0 shipped with multi-config support, enhanced account management, and key bug fixes, while the Global Content Editor now supports in-context navigation editing. Other highlights include unsubscribe surveys to gather feedback, a new Marketplace collection for Breeze Assistant apps, a bug fix for the v3 Marketing APIs, and reminders about critical deprecations: Classic CRM Cards (sunset in October 2026) and Node.js v18 (support ending in October 2025). Together, these changes enhance developer productivity, streamline workflows, and prepare teams for the next phase of HubSpot’s platform evolution.

See additional details below.


New Tooltip Component & Text Transform Options for Text

A new Tooltip component can now be added via the overlay prop on Button, Image, Link, LoadingButton, and Tag, making it easy to provide hover help and inline guidance. See more on the Tooltip docs.
The Text component also supports new textTransform values—uppercase, lowercase, capitalize, and sentenceCase—so you can standardize casing without custom logic. Learn more on the Text docs.

React Hooks to Fetch Properties & Associations for App Cards

We’re introducing two experimental data-fetching hooks for app cards: ‎useCrmProperties and ‎useAssociations. These hooks make it easy for you to access and format CRM record data and associations directly within app cards.

  • useCrmProperties fetches specified properties from the current CRM record, with optional formatting for dates, currencies, and more.
  • ‎useAssociations retrieves associated objects (such as contacts, companies, deals, etc.) with support for pagination and property selection. 

Both hooks also automatically optimize for performance and cleanup. Additionally, the data returned through these hooks respect authenticated user's permissions. You can view examples of these hooks on the dev docs.

HubSpot CLI Release v7.7.0

HubSpot CLI V7.7.0 is a minor release focused on improving the developer experience through enhanced prompts, warnings, and critical bug fixes for local development and test account management workflows. 

New Features:

  • Multi-config support: Added support for multiple configuration values with: hs config set command
  • Enhanced account management: Introduced interactive account selection prompts when running: hs test-account delete
  • Legacy project warnings: Added log warnings when legacy files are detected in v2025.2 projects.

Bug Fixes: 

  • Local development stability:  Fixed a bug where project validation errors caused local processes to exit unexpectedly.
  • Test account creation: Resolved issue where the hs test-account create default option now correctly sets all hub tiers to Enterprise level.
  • Authentication messaging: Fixed allowlist messages to only display for static authentication apps.
  • Local development compatibility: Fixed a bug that caused the local development panel to experience compatibility issues with certain hublets. 

How to Update:

  • New installation: npm install -g @hubspot/cli
  • Existing users: npm update -g @hubspot/cli@latest

Navigation Editing in Global Content Editor

You can now access advanced menus and navigation settings directly within the Global Content Editor. No need to go to Settings—edit menus in context while building your site.

How It Works:

  • A new convenient modal opens within the editor, giving you quick access to advanced menu and navigation settings instead of switching tools.

modal opening within the Global Content Editor.

This update streamlines header and footer creation, reduces context switching, and enhances website-building efficiency for all hubs and tiers.

Collect Feedback with Unsubscribe Surveys

You can now trigger an optional survey on your site’s email preference page to collect feedback about why a contact is unsubscribing from all emails. Use this feedback to gain valuable insights into your marketing email strategy, reduce churn, and improve content relevance without adding friction to the unsubscribe process. Review it in case you want to add CSS styles to your theme for this feature.

Within the Settings > Marketing > Email > Subscriptions tab, you can now enable an unsubscribe survey. Once enabled, any contact who unsubscribes from all email communications will see a short, optional questionnaire on the confirmation page.

Survey options (presets):

  • I'm no longer interested
  • I didn't sign up for your mailing list
  • I receive too many emails
  • Your emails are not relevant to me
  • Other (includes a 50-character open text field)

Where to see results:

  • Contact record: The unsubscribe reason will appear in the contact's activity timeline.
  • Custom report builder: (Professional and Enterprise tiers only) You can build custom reports using the "Marketing email activities" data source and the "Gave reason for unsubscribe" property. Please note that new data may take 10-15 minutes to appear in reports.
  • Marketing Email Performance Page: A chart summarizing unsubscribe reasons will be added to the performance tab of sent emails.

Styling & CCS standardization

Unsubscribe Surveys inherit the Global Form Events styling surface used in HubSpot forms. This means you can theme the survey using the same CSS variables and patterns already documented under Global Form events. For a comprehensive list of supported variables and usage patterns, refer to the Forms reference documentation.

Important Details

  • Available for all Marketing Hub tiers: Free, Starter, Professional, Enterprise.
  • Default state: Enabled by default for new Free & Starter portals and new Marketing Hub customers; disabled by default for existing Professional & Enterprise portals (opt-in).
  • API: Not currently supported; results are available only in the HubSpot UI.
  • Customization: Survey questions aren’t customizable.
  • We’re flagging this for developers so you can update your theme CSS and leverage Global Form Events variables to style the survey.

Apps for Breeze Assistant Collection

During Inbound, we launched a new Marketplace collection that extends Breeze Assistant with powerful third-party integrations. With these apps installed, critical actions from tools like Google Workspace and Microsoft 365 flow directly into Breeze Studio, enabling you to build and customize Breeze Agents easily. This unifies your tech stack with Breeze, making your Assistant smarter, more extensible, and a productivity multiplier. 

To get started, refer to the Marketplace in your HubSpot account or the Marketplace site > Collections > Apps for Breeze Assistant. Then, install the app, connect it to Breeze, and head to Breeze Studio. You’ll see new critical actions ready to be incorporated into your custom agents. The collection features both HubSpot-built and partner-built Agents. And now, Breeze Agents can be seamlessly discovered and installed directly from within the HubSpot Marketplace—streamlining the process of connecting and putting their capabilities to work.

Bugfix: New A/B Email Publishing Support for Marketing Email API

Until now, customers have been unable to publish A/B emails through the v3 Marketing Public APIs. With this change, customers no longer face this limitation, enabling API-driven workflows to include A/B email publishing for those with Marketing Hub Pro and Enterprise subscription tiers.

This was accomplished by updating the content scope to include access to the A/B email type. Developers are not required to add a new scope to their authentication settings, and users should not need to re-authorize your app if they have already approved the content scope. However, if an integration experiences any unusual behavior, please submit a support ticket.

 


Reminder: Deprecating Support for Classic/Legacy CRM Cards

Announced: May 15, 2025

Deprecation Initiated: June 16, 2025

Sunset Date: October 31, 2026

Support for Classic CRM Cards was deprecated on June 16, 2025. New apps submitted to the App Marketplace can no longer include these legacy cards. Existing apps may continue to use Classic CRM Cards until October 31, 2026, when full support will end.

We encourage developers to migrate to app cards built with React, which offers more flexible capabilities. Additional migration support and resources will be available as we approach the sunset in 2026, but you can begin planning your migration now. 

Resources: 

Reminder: Deprecation of Node.js v18

Announced: April 1, 2025

Sunset Date: October 1, 2025

Support for Node.js v18 in HubSpot Serverless functions and CLI ends October 1st, 2025. Existing v18 functions will still run, but you won’t be able to deploy changes without upgrading. New functions must use Node.js v20 or higher. Please update your project framework from v2023.2 to v2025.1 or v2025.2 and CLI (v7.7.0+) before this date to ensure compatibility.

Resources:

 

Questions or concerns? Join us in the Developer Community Forum for a peer-to-peer discussion.