September 2024 Rollup

Dadams · Monday

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.

Developer Updates for September 2024

Expanded Upsert Functionality for HubSpot Contacts 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:

Create: The upsert endpoint will create a new contact record if no existing record with the supplied email is found.
Update: If a record with the supplied email already exists in the CRM, the upsert endpoint will update that record.

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:

// POST /crm/v3/objects/contacts/batch/upsert
{
 "inputs": [
   {
    "properties": {
      "phone": "5555555555"
   },
   "id": "test@test.com",
   "idProperty": "email"
  },
  {
   "properties": {
     "phone": "7777777777"
   },
   "id": "example@hubspot.com",
   "idProperty": "email"
   }
  ]
}

CLI version 6.1.1

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:

New commands:
- hs project migrate-app
- hs project clone-app
Numerous bug fixes and usability improvements including better error handling and messaging.
Account names are now standardized in logs
The CMS Theme preview command now shows in CLI Help information.
hs accounts clean now will check all of your accounts in your config, regardless of expiration date.
Update notification for CLI is now more noticeable.

For a more thorough breakdown detailing the bug fixes and usability improvements see the releases page on GitHub.

Elevate CMS Theme

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.

Knowledge base data is now available in GraphQL

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 assistant in HubDB rich text fields

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.

Public Beta - Sequences API

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.

HubSpot Free Tools Limit Updates

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? Please be sure to leave a comment below!

paradummy · Monday

These are some great new features, I'm looking forward to trying these out. Regarding Content assistant in HubDB rich text fields, are there plans to adding the enabled_features configuration for HubDB? And also adding the content assistant to the configuration (for specific enable / disable this feature)?

Developer Announcements