There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Handling privacy and legal compliance when working with the HubSpot platform

Tracking lawful basis of processing in HubSpot

Under GDPR, companies need a lawful reason to use and process contact data and must keep records of consent and evidence other lawful purposes of processing.

The contact property Legal basis for processing contact's data allows you to collect, track, and store lawful basis of processing via contract, legitimate interest, and/or consent for your HubSpot contacts.

When accessing contact data via the Contacts API, this property uses the name hs_legal_basis. Any contact that has that property set would be accessible through the API as with any other contact property, and the property can also be set or updated for contact records through the API.

However, the options for the property cannot be modified through the API using the Contact Properties API. The property options can only be updated from inside HubSpot, but it is possible to pull any custom options that may have been set for the property through the Contact Properties API. For this reason, it is recommended that your integration use the Contact Properties API to get the options for this property, since individual HubSpot accounts may not use the default settings.

For more details about this property and how it might be used in HubSpot, please see this knowledge base article:

Handling privacy compliant contact deletions

HubSpot users have the ability to permanently delete a contact record to comply with privacy laws. Please see the following help article for more details on this feature:

You can subscribe to the contact.privacyDeletion subscription type to receive webhook notifications when a user performs a privacy compliant contact deletion. Please see the webhooks overview for more details on webhooks, and more details on handling these notifications.