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)
Mappings	List of contact properties to match between Didomi and Hubspot	Yes
Upsert mode	By setting upsert_mode to true you allow Didomi to create contacts in Hubspot	No Default value = false

Example

{
    "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 [email protected] to get the integration's premium feature activated.

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