HubSpot’s October API update delivers enhanced transparency, streamlined migrations, and actionable insights for app developers and integration managers. Highlights include new installation permission requirements for app scopes, a batch endpoint for streamlined list membership migrations, and the introduction of in-app Workflow Action Insights for deeper automation visibility. Developers can now access user engagement and churn analysis data via the HubSpot MCP server CLI, supporting proactive retention and growth strategies. Additionally, previously announced enhanced validation on non-string CRM object properties has been postponed indefinitely following customer feedback—ensuring continued compatibility with current integrations.
For more information, please read below.
This information was originally announced on October 31, 2025 via the Developer Changelog
Bugfix: Product Delete Permission and App Installation
We’ve updated the permissions required to install apps requesting the e-commerce or crm.objects.products.write scopes. Previously, these scopes did not require that the user had permission to delete product records, but would still allow products to be deleted through the CRM APIs. Going forward, users installing apps requesting either of these two scopes will need to have permission to delete products in order to complete the installation.
This update will only affect new app installations going forward, and existing installations with these two scopes will continue to function as expected without requiring the app to be reinstalled.
New Batch List Membership Endpoint Added to v3 Lists API
A new endpoint, /crm/v3/lists/records/memberships/batch/read, allows you to fetch list membership for multiple contact records in a single request. This feature supports migrations from the legacy Contact Lists API (sunsetting April 30, 2026) by enabling batch lookups of list memberships, ensuring smoother transitions and feature parity. Learn more in the Lists API migration documentation.
Introducing Workflow Action Insights in Connected Apps
In early October, we added workflow action insights to each app’s settings page in Connected Apps. This update gives integration managers and admins visibility into how workflow actions from their installed apps are being used within their portal.
By surfacing these insights directly in Connected Apps, customers can better understand how their integrations drive automation and uncover opportunities to increase adoption and value.
For app developers, this feature helps your omtehrations stand out, making it easier for customers to see, use, and expand the app workflow actions within HubSpot.
What’s changing?
For any app that provides workflow actions, a new workflow action insights section now appears in its Connected Apps settings page. This panel surfaces real-time usage data and configuration details for that app’s workflow actions.
Customers of your apps can now see:
- Configured Workflow Actions: Each workflow action that is currently in use, including workflow names, status (on/off), creator, last updated by, and enrollment metrics (total and past 7 days).
- Unconfigured Workflow Actions: Actions available but not yet used, with a direct link to Automation to build a new workflow.
- Adoption Metrics: Enrollment data to gauge adoption and activity trends within the portal.
This update empowers customers to measure the impact of their integrations and helps developers drive deeper automation adoption across their installs.
Public Beta: App Churn Analysis Data Available via HubSpot Local MCP Server
We are excited to announce the release of app churn analysis data for the HubSpot development MCP server via the CLI. This new capability is designed to help developers and app partners gain clear, actionable insights into app usage patterns and user engagement—directly from their development workflow.
What’s changing?
The new app churn analysis feature for the HubSpot development MCP server, available via the CLI, provides developers with actionable insights into app usage and engagement, helping them identify churn risk and respond quickly to trends.
With this new capability, developers can:
- View Usage & Trends: Access detailed data for up to 6 months to track patterns, understand the impact of releases, and see how different segments of your user base are engaging with your app.
- Predict & Assess Churn: Identify churn-prone segments with calculated scores and AI-generated usage summaries over the last 3 months, enabling preemptive action.
- Segment & Diagnose: Analyze your user base by categories—Stable, Increasing, Decreasing, or Insufficient Data. At-risk segments are further broken down by industry and grouped by portal count (specific portalIDs are not shown).
- Receive Recommendations: Get summarized insights and practical suggestions to reduce churn and improve retention, with more detailed recommendations in future updates.
This feature delivers the fast, accessible feedback and user insights that HubSpot app partners and developers need to optimize app performance and boost adoption.
To get started, join the MCP server public beta. Then, follow the instructions in the Developer Documentation. Once your MCP setup is complete, you can test the feature by asking questions such as:
- “Please predict churn for (appID or appName) based on the app API usage for the last 3 months.”
- “Please analyze the API usage for my (appID or appName) for the last 3 months.”
You can also ask “list all my apps” to view all of your apps in your Developer portal if you’re unsure of the specific app ID or app name you would like a churn analysis for.
Cancellation of Enhanced Validation for Non-String Properties in HubSpot CRM Objects API
Originally announce on Oct 6, 2025 via the Developer Changelog
We previously announced that HubSpot would implement enhanced validations for non-string property values to improve data integrity and user experience by prohibiting leading or trailing whitespace characters, including invisible unicode characters from property values. However, we have paused this update indefinitely due to customer feedback and impact. No breaking change will go into effect on our originally stated date of November 10, 2025.
All non-string properties will continue to work as expected. If you have implemented any code changes to address this breaking change, your code will not be impacted, and should continue to function as normal.
Questions or concerns? Comment below for a peer-to-peer discussion or join us on HubSpot’s Public API Workspace on Postman.
