HubSpot's March 2025 update introduces significant developer updates. Providers can now create marketplace listings in any language to enhance global reach, and Custom Workflow Actions now support 14 languages. The Calling Extensions SDK includes inbound calling integration and a redesigned development server interface, streamlining workflows. New app install processes mandate consistent user experience with feature discovery cards, while separate permissions for app installation and uninstallation give admins greater control. A public API for property validation aids in maintaining data accuracy, and a public beta will automatically deactivate exposed tokens by April 2025. The Subscriptions API facilitates creating and managing subscriptions and automates invoicing and payments. Additionally, an interactive guide in the Design Manager helps developers get started quickly.

For additional details, please see below.

Developer Updates for March 2025:

Marketplace Listing Language Restriction Removed

We've eliminated the language restriction in the marketplace listing flow, allowing providers to create listing pages in any language regardless of their app's officially supported languages. Providers now have the flexibility to tailor marketplace pages for specific regional markets without technical limitations, expanding their global reach. The update is effective immediately, and no additional implementation is required.

Language Support Expansion for Custom Workflow Actions

We've expanded language support for the Custom Workflow Actions, adding seven new languages, bringing our total to 14 supported languages: English, French, German, Japanese, Spanish, Brazilian Portuguese, Dutch, Polish, Swedish, Italian, Danish, Finnish, Norwegian, and Traditional Chinese (Taiwan).

The expansion helps global teams navigate and implement automation more effectively by improving accessibility for non-English speakers. It also makes it easier for developers to build and use various labels to provide a seamless localized experience for end-users. Developers can use these new language labels immediately in their custom workflow actions.

Calling Extensions SDK Update: Inbound Calling Now Available

We've expanded the Calling Extensions SDK to include inbound calling support. This update allows developers to integrate third-party calling applications (Aircall, RingCentral, etc.) with HubSpot, enabling users to receive inbound calls from any page within the CRM.

Key Functionality:

• SDK now supports receiving inbound calls in HubSpot.
• Users can navigate HubSpot while on active calls.
• Automated call logging in the Call Index.

Reminder: This is for general CRM calling, not Help Desk channels.

Developer Resources:

• Calling Extensions SDK
• Inbound Call Implementation Guide

Unified Development Server Redesign

The local development server now features a modern, unified interface that simplifies your preview workflow across all HubSpot development approaches: CMS React projects, HubL projects, and legacy HubL themes.

Benefits:

• Single, Intuitive Interface: Preview all types of CMS themes from one dashboard.
• Reduced Context-Switching: Eliminate the need to switch between different local servers.
• Faster Validation: Reduce reliance on production deployments for visual checks.
• Streamlined Workflow: Get instant previews for a quicker local development cycle.

Functionality:

When you start your local development server, you'll now see:

• A modern dashboard displaying theme components (modules, partials, templates).
• Quick-access links to the Slack community and documentation.
• One-click preview options for both local and in-app versions.
• A unified view of all project assets, regardless of technology stack (React/HubL).
• Readily available portal ID and project information.
• Direct "Open in App" functionality for seamless transitions to the HubSpot app.

The server automatically detects your project type and provides the appropriate preview environment, eliminating the need to manually configure or select between React and HubL servers.

Check out this recent Developer HUG event featuring the new UI to see a walkthrough.

Learn more about the local development server.

Updated app install flow in the app marketplace

We've updated the process for listing apps in the app marketplace to provide a unified experience for customers. These changes currently only affect developer accounts created after March 5th, 2025. Accounts and apps created prior to this date will still have the previous functionality for the listing process.

Apps in these accounts will no longer be able to set a custom URL for the app's install button, and will instead select a redirect URL from the redirect URLs configured in the app settings.

Additionally, the listing for these apps must include at least one feature discovery card. We recommend creating a card for any major function or action performed by your app.

Before this change, the "Install" button for any app listed in the marketplace could have one of several different types of pages that users could encounter after clicking the button. These new requirements ensure a consistent and predictable install experience across all apps available on the marketplace, and make it easier for customers to find and successfully use the features of the apps they install.

New App Install & Uninstall User Permissions for Admins

The existing App Marketplace permission has been split into two separate permissions, giving HubSpot admins more granular control over whether certain users can install and/or uninstall apps:

• App Marketplace install access will be required for users to install apps from the App Marketplace or unlisted apps from third-parties.
• App Marketplace uninstall access will be required for users to uninstall apps from their HubSpot account.

Super admin users will continue to have full control over installing or uninstalling apps in their account.

View property validation rules via the new Property Validation API

You can now use a public API to access HubSpot's property validation rules.

Use Case:

This API allows you to understand and adhere to the validations set on properties within HubSpot. By providing access to these rules, it helps you ensure that data sent to HubSpot is consistent and accurate, reducing the likelihood of API call failures and errors.

Functionality:

The API offers two main endpoints:

• Get All Property Validation Rules for an Object:
  • GET crm/v3/property-validations/{objectTypeId}
  • This endpoint retrieves all properties for a specific object type (e.g., contact, deal) that have validation rules.
  • The response includes:
    • propertyName: The name of the property with validation rules.
    • propertyValidationRules: An array containing the rules set for the property, with details like ruleType (the rule category) and ruleArguments (specific rule requirements).
  • Example: To get validation rules for contact properties, use GET crm/v3/property-validations/0-1.

Get Validation Rules for a Specific Property:

• GET crm/v3/property-validations/{objectTypeId}/{propertyName}
• This endpoint retrieves the validation rules for a specific property of an object type.
• The response includes the ruleType and ruleArguments for each rule.
• Example: To get validation rules for the "order_id" deal property, use GET crm/v3/property-validations/0-3/order_id.

Learn more in the developer documentation.

New getting started guide in the design manager

We know getting started with HubSpot development can be challenging when you have to jump between multiple documentation pages. You can now access an interactive getting started guide directly in the Design Manager that walks you through HubSpot development fundamentals - from setting up local development to building with React and HubL. The guide helps you:

• Get your local development environment set up quickly with the HubSpot CLI
• Start building themes and modules using either HubL or React and understand the benefits of each approach.
• Understand how to use the developer projects framework and new HubSpot's build and deploy pipeline.

Functionality

You'll find the guide in two places:

• Look for the welcome modal when you first access Design Manager
• Click the "Getting Started" button at the bottom of the Design Manager

View Domain Names of App Marketplace Listing Traffic

A new chart has been added to the Listing Analytics tab within the App Partner Dashboard. This new chart is “Pageviews by Domain” and displays the domain name and number of times users from that domain have visited your app listing. 

Anyone with a listing on the HubSpot App Marketplace has automatic access to this information in their app partner portal.

Public Betas

Reminder: Public Beta for Automatic Deactivation of Exposed Tokens

On October 8th, 2024, HubSpot launched the public beta of an automatic deactivation feature for any tokens exposed in public GitHub repositories, aimed at enhancing platform security by mitigating the risks associated with leaked tokens. The feature, which will become fully enforced on April 7th, 2025, deactivates exposed Developer API Keys, Personal Access Keys, Private App Tokens, and SMTP Tokens, notifying affected customers and technical contacts while providing a remediation guide. Developers should ensure tokens are secure and generate new ones if needed before the enforcement date to prevent service disruptions.

Create and Manage Subscriptions with HubSpot's Subscription API

With the added functionality of the Subscription API, you can now use it to create and manage subscriptions within HubSpot. This update introduces the ability to:

• Create Subscription Data: Create subscriptions and store related data as CRM records on the Subscription Object.
• Automate Invoicing: Generate invoices automatically from subscriptions and facilitate payments.

Use Cases:

• Connect subscriptions to external applications and keep data in HubSpot synchronized.
• Initiate billing and payment collection directly within HubSpot.

Functionality (New Create Functionality):

This update focuses on the ability to create subscriptions. Here's how it works:

• Create subscriptions by providing at least a subscription name. All other fields are optional initially, and the subscription can be converted to a billable subscription later.
• Most subscription properties can be set in the request, except for calculated properties.
• Subscriptions can be associated with contacts, companies, deals, line items, invoices, and payments.

Functionality (Invoicing & Payments):

You can also leverage subscriptions to automate invoicing and payment collection:

• Set the "Invoice Creation" property to "On" to have invoices generated automatically on each billing date.
• Subscriptions must have an associated contact and recurring line item.
• Invoices generated by subscriptions can be paid digitally via HubSpot Payments or Stripe, or marked as paid for offline payments.
  • Note: Edits to all subscription properties are not currently supported for subscriptions that create invoices. Updatable properties are limited to Name, Owner, and Automatically email invoices.

For more details, please refer to the Subscription API documentation.

Questions or comments? Please refer to our peer-to-peer developer community forum.