Our October update brings you information on the new Developer Feedback form, updates to our email subscription management status system, expanded functionality to the Custom Event Creation API, a new CLI update, along with public beta updates for UIE, the Campaigns API, a new Delete Endpoint for the Custom Channels API and a new Mobile Chat SDK.

Developer Updates for October 2024

You can now submit your feedback to our dedicated Developer Feedback Form

At HubSpot, we deeply value developer feedback and are dedicated to empowering your business to Grow Better. Help shape our platform by sharing your honest, unfiltered feedback by submitting to our developer feedback form.

Our Developer Advocacy team personally reviews submissions, ensuring your voice is heard by the dedicated engineers who work to improve our product on a daily basis. Rest assured, your input has a direct impact on shaping the future of our platform.

Please note, while we review submissions, we are not able to respond to all feedback that is submitted through this form.

HubSpot Email Subscription Status Sync

HubSpot has updated its email subscription management system approach to ensure consistency across all communication preferences. The update introduces automatic synchronization between global email opt-outs and individual subscription statuses, effectively resolving any 'mixed' state inconsistencies in contact preferences. This improvement also includes retroactive alignment of historical subscription statuses with contacts' global communication preferences.

New Behavior
When a contact opts out of all email communications, the system now automatically sets all underlying subscription types in their portal or Business Unit to "unsubscribed." This approach prevents contacts from entering a 'mixed' subscription state and maintains consistency regardless of where the "unsubscribe all" action takes place.

Data Updates
For existing contacts with 'mixed' states, individual subscription statuses will be automatically updated to reflect their global communication preferences. The system will synchronize individual subscription timestamps with the original "unsubscribe from all emails" request date. These updates are applied across all subscription types within the affected portal or Business Unit.

Notes
No action is required from users; all necessary changes will be applied automatically to your HubSpot portal. The change affects both existing contacts with 'mixed' states and prevents future inconsistencies in subscription statuses. However, portals may see some contacts added to lists and/or enrolled in workflows based on the individual subscription type statuses after it is changed to unsubscribed.

Expanded Functionality to the Custom Event Creation API

The Custom Event Creation API has been updated to include some new functionality for users:

• We now have a batch create endpoint that allows you to add up to 10 event completions at a time. API users can leverage the /events/v3/send/batch endpoint to send along event completion data.
• The API now supports multi-value enumeration properties. You can send more than one value into an enumeration property by separating the data with a semicolon. This is useful for multi-select custom event properties.

CLI 6.2.1

This update is primarily bug fixes and behind the scenes changes for improving error handling and logging. To update to the latest version of the HubSpot CLI run npm install -g @HubSpot/cli@latest in your terminal.

Public Betas

UI Extensions Beta Updates

This month, the UI extensions public beta added a new charts UI components and the Figma design kit. Please see below for more information.

• Charts UI Component
  HubSpot's UI extensions offer two versatile chart components—BarChart and LineChart—designed to visualize third party data for both private and public apps. The BarChart is great for comparing categorical data, while the LineChart is ideal for visualizing trends over time. Both components share a consistent API, requiring three main props: data for the dataset, axes to configure x and y axes, and options for chart settings like tooltips and legends. These charts support customization, including stacking, color configuration, and axis labels, ensuring clarity and performance even with larger datasets. Explore more through HubSpot’s Charts example projects or the Developers YouTube channel for implementation guidance.
• Figma Design Kit Beta
  The Figma Design Kit provides a visual toolkit for planning React-based app cards within HubSpot's UI extensions. It offers detailed examples of UI components, wireframes for app card anatomy, and various build locations, making it a valuable resource for aligning development teams and showcasing demos to stakeholders. Though in beta and subject to updates, the kit ensures smooth collaboration by providing a structured design framework. Users can access the kit via Figma, duplicate it to their drafts, and stay updated through periodic releases. Refer to the UI component documentation and changelog for the latest component availability.

If you have any inquiries or concerns, please contact us via the Developer Slack channel, #crm-customization-beta.

Campaigns API

We've recently released the Campaigns API into public beta. The Campaigns API lets your integration create, manage, and analyze marketing campaigns.

The current beta supports these features:

• Retrieve existing campaigns, and create, update, or delete existing campaigns. The beta also includes batch APIs for these functions.
• View assets associated with a campaign, associate new assets, or remove assets from a campaign. Note: The beta currently only supports associating forms, static lists, and external website URLs.
• Retrieve analytics for campaigns, including the contacts associated with a campaign, the revenue attributed to the campaign, and budget of the campaign.

See the documentation and API reference for more details, and keep an eye on the changelog for future updates to this API.

New Delete Endpoint for Custom Channels API Beta

The Custom Channels API beta now includes an endpoint to archive custom channels. This endpoint allows developers to remove a registered custom channel from active use. Archiving a channel is essential for managing outdated or unused channels.

API Endpoint:
DELETE /conversations/v3/custom-channels/{channelId}

A successful request will return a 204 status, confirming that the custom channel has been archived.

This update provides greater flexibility and control for developers who integrate custom channels into the HubSpot platform, improving channel management. For additional information, please refer to the API documentation.

New Mobile Chat SDK

The Mobile Chat SDK allows a developer of any iOS or Android apps to integrate HubSpot chat into their app. This integration provides a native, contextual support experience, enabling in-app self-service through customer agents, knowledge bases, and bots. Developers can easily configure and customize chatflows, while capturing crucial customer information to enhance support efficiency. More information available in the HubSpot Knowledge Base.

Questions or comments? Discuss these updates on our developer community forums.