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. 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. 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


Upsert mode

By setting upsert_mode to true you allow Didomi to create contacts in Hubspot

No Default value = false


    "type_id": "hubspot",
    "authentication": {
        "code": "AUTH_CODE"
    "properties": {},
    "mappings": [
            "id": "hubspot_email_enabled",
            "value": "consents_preferences_newsletter_enabled"
    "upsert_mode": true,
    "app_id": "YOUR_PORTAL_ID",
    "enable_webhooks": true

The configuration of the Hubspot integration can be done in the Didomi Console. First please reach out to to get the integration's premium feature activated.

Learn how to configure Didomi-Hubspot integration in the Didomi Console in this help center documentation.

Last updated