Hubspot

Search…
Hubspot
Introduction
Didomi allows you to synchronize your Hubspot contact properties with the preferences collected through Didomi consent events.
Implementation
Connection
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 https://didomi.io. 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.
Options
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.
Mapping
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.
Configuration
Didomi needs the following configuration items to set up the connection with Hubspot:
Property
Description
Required
Authorization code
Authorization code returned by the redirect URL after installing the Didomi Hubspot App
Yes
Portal ID
ID of your Hubspot portal
No (only required for bidirectional flow)
Properties
List of contact properties to match between Didomi and Hubspot
Yes
Example
{
    "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.
Braze
Mailchimp
Last modified 2mo ago
Copy link
On this page
Introduction
Implementation
Connection
Options
Mapping
Configuration
Example