HubSpot Developer Changelog

New property limits for the Custom Behavioural Events API

Written by Rahmona Henry | Sep 3, 2021 2:04:46 PM

We are introducing new property and value limits for the Custom Behavioural Events API which is currently in beta.

What's changing?

On September 20th 2021 we will be introducing the following property limits to the Custom Behavioural Events API.

  • The property label and internal name are limited to 50 characters.

  • URL and referrer properties can receive up to 200 characters, while all other properties can receive up to 50 characters.

  • Each event completion can contain data for up to 50 properties.

  • Property internal names must start with a letter and contain only lowercase letters a-z, numbers 0-9, and underscores.

  • Properties with the same internal name after lowercasing are considered duplicates, and only one of the properties will be used on completion. We will sort in ascending lexicographical order and keep the last property seen among the first 50 properties.

If these limits are exceeded when making an HTTP API request, the request will fail and we will return a detailed error message to let you know which limit was exceeded.  If these limits are exceeded when making a JS API request, HubSpot will truncate any property name values to the allowed length and/or update only 50 properties per event completion.


When is this happening?

The new limits will be introduced on September 20th 2021.
Please let us know if you have any feedback or questions by joining the conversation in the community.