HubSpot Developer Changelog

Developer updates for January 2026

January’s developer updates focus on making HubSpot apps more flexible, scalable, and integration-friendly. Highlights include major improvements to UI Extensions, expanded API capabilities, enhanced sandbox and event management, Marketplace analytics upgrades, and new public betas that unlock deeper access to forecast and subscription data.

 

UI Extensions: p_* wildcard enables cards for all custom objects

UI Extensions now supports a p_* wildcard in card configuration, letting you target all custom object types in a portal without listing individual schema names (like p_my_object) or portal-specific fully qualified names (like p123456_my_object). This removes a major blocker for public apps, since custom object names vary by customer portal—apps can now work across any customer’s custom objects without hardcoding object IDs. To use it, set the object target in your card config to p_* instead of a specific custom object name.

 

Breeze Studio agents upgraded to GPT-5

Breeze Studio agents now default to GPT-5 instead of GPT-4.1, including Marketplace agents like Deal Loss, Customer Health, Customer Handoff, and Social Post, as well as custom agents in private beta. Developers and customers should see improved reasoning and overall agent performance, with no action required for new agents. Existing agents created before December 1 have been automatically upgraded as of January 12, 2026—note that this change does not affect the Customer, Prospecting, or Data Agents.

 

Sync Single Sign On (SSO) Settings to Sandbox and Developer Accounts

When you enable Single Sign-On (SSO) on a production account, those settings now automatically carry over to any newly created Sandbox or Developer test accounts. This simplifies security setup and ensures non-production environments meet the same authentication standards without extra configuration.

Note that this does not retroactively apply to existing sandboxes created before SSO was enabled on production.

 

Enhanced Quote Design with HTML Editing

Commerce Hub quotes now support source code editing in the rich text editor, allowing users to view, edit, or directly write the underlying HTML. This unlocks advanced customization for quote templates, including custom layouts, branding styles, responsive content, and embedded assets that go beyond standard rich text controls. Template creators can now build quotes that behave more like modern web pages, eliminating fragile workarounds like image-based layouts.

How does it work?

  • Going to Settings > Objects > Quotes > Quote Templates
  • Within the Quote Template Editor, click into any content section
  • Click Advanced > Source Code

  • Edit the HTML and click “Save changes”

  • Review the rendered content before publishing the quote template

 

Quotes created from the quote template will automatically pull in the source code into the rich text sections. Source code cannot be edited at the quote-level. 

Learn more in the Commerce Hub Quotes documentation.

 

Custom events can now be deleted

You can now delete individual custom event occurrences directly from the Event Management tool, making it possible to clean up test events or incorrect data that previously couldn’t be removed. This helps keep reports, lists, workflows, and CRM records accurate and trustworthy. Deletions are available in-app only, support bulk deletes of up to 100 occurrences at a time, and are capped at 1,000 deleted events per month.

 

New Sandbox Listing Page

We’ve rolled out a redesigned Sandboxes listing page that centralizes sandbox management and production deployment tracking in a more intuitive layout. The update introduces a consolidated Sandboxes tab, a centralized activity log (covering sandbox creation details, deployments, and deletions with filtering by activity or user), and always-visible “Create a Sandbox” and “Set up a Deploy” CTAs at the top of the page. This improves information architecture and makes it faster to access sandboxes, review historical activity, and use deploy-to-production features. Availability is limited to users enrolled in the private or public beta for the new Standard Sandbox with improved production metadata and supported deploy-to-production assets.

 

Pre-rendering warnings now appear in Design Manager

To improve site speed, HubSpot automatically creates static versions of pages, blog posts, and knowledge base articles when possible. However, some HubL variables and functions are incompatible with pre-rendering. Before, you had to use ?hsDebugOnly=true.

Now, you can see warnings in the Design Manager about whether the page can be pre-rendered or not. Then, make changes to the code directly to address these warnings.

To opt-in to this feature, go into the Design Manager, open the Design Manager settings and toggle the Enable Pre-rendering Warnings on.

 

Breeze Customer Agent Now Supports Omnichannel Deployment via Custom Channels API

Breeze Customer Agent can now be deployed on ecosystem-built channel integrations, including SMS, Instagram, Telegram, LINE, WhatsApp, and Slack. Through the Custom Channels API, developers can integrate any messaging channel to Help Desk or Conversations Inbox. Customer Agent now works on any Custom Channels API channel.

What does this mean for developers?

Developers’ messaging integrations gain a powerful AI feature that makes them more valuable to customers, and any existing integration is ready to go, with no code changes necessary. Sales and Service Hub Professional and Enterprise customers can deploy Customer Agent to custom channels. This means your integrations can now do the following:
  • The ability to assign Customer Agent to a custom channel from either the Customer Agent or channel connection setup user flows.
  • Adjust customer agent handoff behavior.
  • The Customer Agent responds to incoming queries on your channel.

Note: If you are installing new channels into your existing Marketplace apps and customers have previously installed the app, you may need to ask them to re-authorize the app to grant it access to the Custom Channels API scopes.

To get started, please refer to the documentation and explore which Marketplace app offers this functionality out of the box.

New Campaign Asset Type Associations via Campaigns Public API

We are enhancing the Campaigns API to support associations with an expanded range of campaign asset types. Developers can now programmatically add, list, or remove 11 additional asset types to campaigns, mirroring what’s possible within the HubSpot platform.

What's new?

You can now associate the following asset types with a campaign via the API:

  • Ads (AD_CAMPAIGN)
  • Blog Posts (BLOG_POST)
  • Files (FILE_MANAGER_FILE)
  • Landing Pages (LANDING_PAGE)
  • Marketing Email (MARKETING_EMAIL)
  • Marketing Events (MARKETING_EVENT)
  • SMS (MARKETING_SMS)
  • Social Posts (SOCIAL_BROADCAST)
  • Video (MEDIA)
  • Website Pages (SITE_PAGE)
  • Workflows (AUTOMATION_PLATFORM_FLOW)

These asset types are supported by the following API endpoints:

Note: Previously, these types had to be managed via the HubSpot platform, with only a subset available through the API.

Developers can begin reviewing and updating integrations if using custom apps or workflows to manage HubSpot campaigns, using the required asset types.

Example payload for asset association:

{"campaignGuid":"your-campaign-guid-here","assetType":"MARKETING_EMAIL","assetId":"your-asset-id-here"} 
 

Please refer to the developer documentation for full endpoint details.

 

Company Lifecycle Stage Properties

Each lifecycle stage now has four new company properties that track the company's progression through its lifecycle:

  • Date entered stage
  • Date exited stage
  • Latest time in stage
  • Cumulative time in stage

These properties help you understand how companies move through your sales process. These company properties are automatically created for each lifecycle stage including any custom lifecycle stages created in an account.

 

Partner Search Analytics

App partners now have access to search analytics! This lets you track how marketplace searches enable discovery in the HubSpot Marketplace, including key metrics like:

  • How often your app appears in search results (impressions)
  • Which search terms lead to clicks on your listing
  • Ranking position for each term (1 = top result)

You can now monitor trends over time to understand how listing updates affect visibility.

You can see search analytics right in your developer account under the app’s Marketplace Analytics.

 

Marketplace Updates

We have two quick updates for managing your app marketplace listings.

We've migrated autotranslate to our unified marketplace platform, fixing recent bugs, and improving the submission experience + end customer translations. If you already have translated listings (manually or automatically created), you won't see any changes - this update enhances reliability and streamlines new submissions.

This update will mean more reliable translations, and the autotranslate checkbox will be pre-selected, making it quicker and easier to get better translations for your listing.

We are also increasing the limit for review responses in the HubSpot Marketplace from 1 to 2. This will allow you to create 2 responses for any reviews, one to acknowledge the issue and one to notify the customer that the issue has been fixed.

 

Custom event updates

We have several updates for custom and app events.

Custom events created via webhooks often capture key integration data from across your tech stack, and until now, these events weren't shown in the activity timeline, didn't have the same property options as other custom events, and couldn't be edited after creation. Now, webhook Custom events function like other custom events. When a rep opens a record, they can now see any event triggered via webhook—without leaving HubSpot or running a report.

Custom events now supports the importing of event data to backfill historical data, integrate data from your tech stack with HubSpot, or capture offline behaviors you want to represent as events in HubSpot. Previously, imports could only be done as a separate, standalone event type. Now, when choosing import, you can import data to an existing event type. Additionally, imports previously only supported contact based events. Events can now be created via import for any object type Custom events supports.

We've updated the event management page to make it possible to dismiss errors for custom events. Previously, Custom event errors stay on the main event management page for 30 days, regardless of whether the issue has been resolved. Now, you can dismiss the error badge to no longer be notified about this issue for this event.

Finally, custom events and app events can be linked to several additional object types. Previously, app events and custom events could only be linked to Contacts, Companies, Deals, Tickets, and Custom objects. Both event types can now be linked to Leads, Projects, Services, Orders, Courses, Listings, and Appointments.

 

Public Beta: Forecast Read API

We’re excited to announce the BETA release of our Forecast Read API, available to Sales Hub/Service Hub Professional and above. This new API enables customers to access their forecast submissions from HubSpot in a structured, queryable, and read-only format—ideal for Business Intelligence (BI) reporting, analytics, and integration into data warehouses. With this release, customers can now self-serve and programmatically retrieve forecast data, advancing data accessibility and integration capabilities.

What's changing?

  • Read-only API access to all HubSpot forecasts, no UI changes required.
  • Structured data retrieval: Query specific fields and integrate results into BI tools or data warehouses.
  • Integration-ready: Use your authenticated app (crm.objects.forecasts.read scope) to access data programmatically.
  • No UI/UX changes are required: Usage is fully programmatic through the API, and there are no changes to your HubSpot account via the forecast tool.
  • Beta program: This feature is in BETA. By participating, you agree to HubSpot’s Developer Terms and Beta Terms. Functionality and endpoints are subject to further development and changes.

Usage

Authorize your app with the crm.objects.forecasts.read and the oauth scope to use the endpoint. Below are the listed new read-only endpoints:

  • Get all forecasts:

GET /crm/objects/v3/forecasts?properties=property1,property2
  • Get by ID:
GET /crm/objects/v3/forecasts/{id}

Example response:

{"results":[{"id":"475911884905","properties":{"hs_created_by_user_id":"2620022","hs_createdate":"2025-10-10T19:42:51.001Z","hs_lastmodifieddate":"2025-10-14T16:52:43.757Z","hs_milestone":"monthly","hs_object_id":"475911884905","hs_team_id":"39577840","hs_year":"2025"},"createdAt":"2025-10-10T19:42:51.001Z","updatedAt":"2025-10-14T16:52:43.757Z","archived":false}]}

For more details, please refer to the HubSpot API Developer Documentation.


Public Beta: Securely generate a preference page URL

The Preference Link Generation endpoints allow you to generate secure URLs to the Manage Preferences and Unsubscribe pages for any contact in your HubSpot CRM. This will allow your contacts to manage their email preferences directly from account settings or other authenticated areas of your website without requiring them to re-enter their email or dig up a past marketing email.

 

We've added to our Subscriptions Public APIs v4 so that you can call the new POST /communication-preferences/v4/links/generate endpoint with a contact’s email (subscriberIdString), optional language, and (for a single unsubscribe) a subscriptionId. You’ll receive secure, contact-specific links to:

  • Manage Preferences page
  • Unsubscribe from All page
  • Unsubscribe from a Single Subscription Type page

For more information on how it works refer to the developer documentation.

 

Join the discussion in the Developer Community.