Didomi allows you to synchronize your Hubspot contact properties with the preferences collected through Didomi consent events.



Didomi connects to your Hubspot account through the Didomi Hubspot App. By installing the app and configuring the integration, you allow Didomi to update your Hubspot contact properties every time users change their preferences through the Didomi Platform.

Didomi Hubspot App

To get started using the Didomi Hubspot App, you can follow these steps:
  1. 1.
    Go through the Installation link and grant access to the Didomi App on the Hubspot account you'd like to link with Didomi. This will grant access to Didomi to update your contacts as well as react to contact updates.
  2. 2.
    After the installation, you'll be redirected to The redirected link will contain a code parameter. This is the authorization_code to send as a configuration item on the following section.
The authorization_code expires within 1 hour. Please make sure the configuration of your Hubspot integration is done before the code expiration.


Upsert mode

You can choose allowing Didomi to create contacts in Hubspot, by setting upsert_mode to true. Otherwise, when a consent is collected but the organization_user_id value does not match with any contact in Hubspot, the consent update will not be propagated to Hubspot.

Bidirectional flow

Didomi also supports a bidirectional flow by creating a Hubspot webhook to react to your contact changes and update your Didomi users accordingly. Didomi identifies your Hubspot contacts using the organization_user_id property.
Didomi also creates a Didomi Changed property on your account that can be used on Workflows when you want to trigger an update from your Hubspot contact. For example, you can create a workflow that increments this property by 1 every time a contact update should be triggered on the Didomi Platform. This makes sure that your Didomi user is up to date with the changes performed by Hubspot.


Didomi uses the entity contact of Hubspot and sends the attributes property when updating a contact. Hence consent events are mapped to the contact attributes.


Didomi needs the following configuration items to set up the connection with Hubspot:
Authorization code
Authorization code returned by the redirect URL after installing the Didomi Hubspot App
Portal ID
ID of your Hubspot portal
No (only required for bidirectional flow)
List of contact properties to match between Didomi and Hubspot


"app_id": "YOUR_PORTAL_ID",
"upsert_mode": true,
"config": {
"authentication": {
"authorization_code": "AUTH_CODE",
"expires_in": 3600
"properties": [
"id": "hubspot_email_enabled",
"value": "consents_preferences_newsletter_enabled"
The configuration of the Hubspot integration cannot be done in the Didomi Console at the moment. Please reach out to [email protected] to get your Hubspot integration configured and provide the elements listed above.
Last modified 6mo ago