Announcing a change to how CRM object property creation is validated in v3 endpoints
Announced: November 2, 2020
Live: February 1, 2021
When creating new properties for CRM objects via the HubSpot APIs, both a
fieldType value are required. The
type value is used to determine what data can be stored in the property, while the
fieldType value is used to determine how the field is presented in the HubSpot app. There’s a close correlation between the
fieldType values, and setting a
fieldType that don’t work together can result in unexpected behavior for the user.
Up until now, we have not been validating that
fieldType values were being used correctly. Starting on February 1, 2021 we’ll be enforcing this validation for our newer “v3” endpoints, documented on the Properties API page and the Custom Objects API page. After that date, requests with incorrectly correlated
fieldType values will return an error. We’ve added more information about the relationship between
fieldType to our documentation to assist you in making any required updates to your code.
Note that older versions of these property-creating APIs (the CRM Object Properties API, the Contact Properties API, and the Company Properties API) will continue to work without this validation, so no changes are required on integrations using those APIs. New integrations should use the newer, "v3" APIs.
If you have any questions or comments, please leave a note in the forum thread.