Developer Announcements

HubSpot Employee
HubSpot Employee

New property limits for the Custom Behavioural Events API

What’s changing? 

On September 20th 2021 we will be introducing the following property limits to the Custom Behavioural Events API  which is currently in beta. 

  • 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 change happening?

The new limits will be introduced on September 20th 2021. 
Please let us know if you have any questions by replying below.


Rahmona Henry
0 Replies 0

0 Replies

No replies on this post just yet

No one has replied to this post quite yet. Check back soon to see if someone has a solution, or submit your own reply if you know how to help! Karma is real.

Reply to post

Need help replying? Check out our Community Guidelines