HubSpot

HubSpot (opens in a new tab) is a customer relationship management (CRM) platform that helps customers with inbound marketing, sales, and customer service.

Prerequisites

In order to integrate with HubSpot, you'll need to collect the following information:

Integrating with HubSpot

To integrate an existing system with HubSpot:

1. Navigate to Data map → View Systems and choose the system that you want to connect.
2. Click on the Integrations tab.
3. Pick the vendor or system type that you want to integrate with from the Connection type drop-down menu.
4. Complete the required fields for the integration and click Save.

You may confirm your connection is working using the Test connection button, if desired.

To learn more, please see our guide for Managing Integrations.

Consent automation

HubSpot also supports consent automation. To configure this, click on the Consent Automation accordion under the HubSpot configuration form. This section allows you to map Privacy Notices in Fides to Email Subscription Preferences in HubSpot. In the example below, setting Marketing for the Marketing information subscription will automatically subscribe and unsubscribe the user from that subscription if they opt-in or out of the Marketing privacy notice in Fides.

Consent webhooks

HubSpot also supports Workflow Webhooks (opens in a new tab) so we can use that functionality to post privacy preferences to Fides.

1. Within the HubSpot dashboard, navigate to Automations > Workflows and click on Create Workflow > From Scratch.

2. Create a blank workflow: Choose the Contact-based option.

3. Set up the enrollment trigger:
   • Select When an event occurs as the trigger type.

• Add Updated email subscription status as the criteria.

• Enable Re-enrollment, then save the trigger.

4. Add a webhook action:
   • Click Add an action, then select Data Ops > Send a webhook.

• Method: POST.
• Webhook URL:

https://your_fides_url/api/v1/plus/connection/{{connection_identifier}}/consent-webhook`.

Make sure this URL is reachable via the public internet

• Authentication type: API Key.
• API Key: Use the token retrieved from the consent webhook token endpoint formatted as Bearer {token}.
• API Key name: type 'Authorization'.
• API Key location: Request header
• Request body should be set to Customize Request Body. Add a property with key email and value enrolled contact - Email.

• Once everything is configured, Save the action.

5. Click Review and publish > Skip to turn on > Turn on workflow.

By configuring this workflow webhook. Any subscribe and unsubscribe preferences that happen inside of HubSpot will be automatically forwarded and stored within Fides.

Technical detail

Fides utilizes API endpoints to access the API service for a SaaS application. An API service is the programmatic interface through which Fides can query and update data within an application to access, rectify, or delete personal information. Each SaaS tool will have a unique set of endpoints to enable privacy functions.

HubSpot Endpoints

In the table below, you can find which endpoints are used for each type of privacy function. Clicking on the endpoint will take you to the documentation for that endpoint.