Upcoming - Increased validation for contact updates made through APIs

Dadams — Thu, 23 Feb 2023 19:40:07 GMT

Beginning on May 22nd, 2023, we will be updating our APIs to use more strict validation for updates made to contact records.

What's changing?

We're updating the validation for two property types.

For number properties, values cannot contain commas, and can only contain a single period. The following examples will be invalid after this update:

5,333,222
23.345.567,23

For any enumeration type properties, values can only include options that exactly match one or more of the `options` set for the property.

For example, if you have a select property with the options "alpha", "beta", and "gamma", the value must match one or more of those defined options and cannot include any other items. The following would be invalid after this update:

"alpha;delta"
"omega"

This change will affect all updates made through any version of our Contacts APIs, including:

The legacy Contacts API (/contacts/v1/)
The CRM v3 Contacts API (/crm/v3/objects/contacts)

This update will only affect contacts, since this validation is already in place for other CRM objects.

Why is this changing?

In addition to improving the consistency and quality of data stored in HubSpot, this update brings contacts in line with previously made validation updates. While this validation was in place for other CRM objects, there were some cases where this validation was not always applied for contact records for some of our APIs.

When is this happening?

This validation will be applied starting on May 22nd, 2023. After this, any contact updates (including creating contacts) containing the values detailed above will return an error indicating the invalid property values.

Please let us know if you have any questions by replying below.

Re: Upcoming - Increased validation for contact updates made through APIs

thuey — Tue, 16 May 2023 13:49:25 GMT

Is there a reliable way to find out ahead of time if we are making any requests that will start failing, such as with Sandbox accont?

Re: Upcoming - Increased validation for contact updates made through APIs

VBossio — Mon, 08 Jan 2024 14:50:24 GMT

Is there any documentation that describes all of the "data integrity" validation that occurs when a contact is added or updated through the API? I have seen "Contact already exists" exceptions returned by the API when trying to add a contact with the same email as an existing contact. But I have also seen the same error when adding a contact and the email does not exist in Hubspot but the contact first and last name already exists in Hubspot.

topic Re: Upcoming - Increased validation for contact updates made through APIs in Developer Announcements

Upcoming - Increased validation for contact updates made through APIs

What's changing?

Why is this changing?

When is this happening?

Re: Upcoming - Increased validation for contact updates made through APIs

Re: Upcoming - Increased validation for contact updates made through APIs