Following up on all of the new features announced at Inbound, we have a few more new features for Developers. September brings updates to the upsert API for contacts, an updated version of our CLI tools, a new CMS theme, knowledge base data in GraphQL, content assistant in rich HubDB fields, and the public beta for our Sequences API.
HubSpot is excited to announce the expansion of the upsert functionality in the Contacts API to now include email addresses. Previously, the upsert feature allowed users to create or update records in bulk, but "Upsert by email" was excluded due to the requirement that idProperties be defined as unique. With this latest update, the upsert endpoint can now handle emails, removing the uniqueness constraint and streamlining data management.
Behavior:
This enhancement reduces the risk of creating duplicate records and simplifies operations by consolidating create and update actions into a single API request. Users can sync and manage data more efficiently without performing lookups before submitting requests.
API users can leverage the /crm/v3/objects/contacts/batch/upsert endpoint with emails. For example, see below how you can update phone number properties for contacts with emails like test@test.com and example@hubspot.com:
If you've watched our CLI GitHub repository you'll have noticed we put out a number of CLI releases in the last month and a half. The latest of which is v6.1.1. To update to the latest version of the HubSpot CLI in your terminal run:npm install -g @hubspot/cli@latest
Changes since the last announcement:
hs project migrate-apphs project clone-apphs accounts clean now will check all of your accounts in your config, regardless of expiration date.For a more thorough breakdown detailing the bug fixes and usability improvements see the releases page on GitHub.
We've released a new theme for all tiers of Content Hub. The primary difference from this theme and prior HubSpot default themes is a streamlined way of organizing theme settings and styling modules. Developers, you can access this theme inside the @HubSpot folder in your design manager or through the HubSpot CLI to learn from, clone, or create a child theme.
HubSpot's GraphQL support in templates, modules, and our API endpoint now support retrieving data from the account's Knowledge base. Whether you're building with React or HubL, building websites, apps or UI Extensions, you now have the ability to display and make use of data in the knowledge base through GraphQL. To see what data you can retrieve and get the ideas flowing - Open GraphiQL in your account and click on kb.
Content editors can now utilize the AI content assistant inside rich text cells in HubDB. Similar to other rich text fields, marketers can utilize slash and highlight commands, or select the "AI content assistant" option in the rich text toolbar.
We're excited to announce the public beta for our Sequences API. This new API will allow developers to build integrations that access HubSpot Sequences externally.
Users might enroll customers into a sequence from data or information in a tool outside of HubSpot. Now with the Sequences API, partners and developers can make sequences available right within the systems that customers are using.
See our beta documentation for more details.
As a final update, we've recently changed some of the limits for newly created accounts using our free tools. Check our Product & Services Catalog for up-to-date limits for free and all other account types.
Questions or comments? Discuss these updates on our developer community forums.