Breaking Change for v3 Lists API Beta

The v3 Lists API beta currently accepts both integers and strings for the ID of public folders used for list segmentation and returns the ID as an integer. We will be updating the IDs to use only strings in order to conform to the HubSpot specifications.  This will go into effect on April 28th, 2025

What’s Changing

Currently, you can format a public folder ID as either an integer (INT) or a STRING in your request body.  Going forward, only strings will be accepted.  Furthermore, when getting a response, you should expect to see a string rather than an integer.  

Example JSON body of a POST request with the updated field highlighted:

Example JSON body of a response with the updated fields in bold:

When is it happening?

This change goes into effect on April 28th, 2025.

Questions or comments? Join us in the developer forums.