Announcing a change to how CRM object property creation is validated in v3 endpoints

When creating new properties for CRM objects via the HubSpot APIs, both a

type

and

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

type

and

fieldType

values, and setting a

type

and

fieldType

that don’t work together can result in unexpected behavior for the user.

Up until now, we have not been validating that

type

and

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

type

and

fieldType

values will return an error. We’ve added more information about the relationship between

type

and

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 here in the forum thread.