---
title: Hubspot connector (CMS 12)
slug: cms-12/docs/hubspot-connector-cms-12
docTags: 
createdAt: 2026-08-10T15:55:54.000Z
---

:::hint{type="info"}
**Note**

The [Optimizely Digital Experience Platform (DXP)](https://www.episerver.com/products/dxp) contains many features to support you in your daily work. Depending on how your solution is set up, some features described in this documentation may not be available.
:::

The HubSpot connector add-on automatically exports form data from your website to your HubSpot account database by mapping Optimizely form fields to HubSpot database fields. For information about other database connector add-ons, see [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

## Set up Optimizely forms with HubSpot

The Forms Marketing Automation Integration (MAI) connector lets you connect [Optimizely form fields](docId\:KVnsZDpxrq5wlYjBejT3W) to a HubSpot database. See also [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

:::hint{type="info"}
**Note**

A developer must install the Forms Marketing Automation connector and the HubSpot connector.
:::

1. In the app selector, select **Addons > Marketing Automation**.
2. Click **Create**. The **Add connector** view displays.

   ![Add Hubspot connector](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/2oKECwEIkWpHoM6BIbJNU-20260720-145610.png)
3. Select **HubSpot** from the list of the available connectors. The HubSpot configuration settings screen displays.

   ![HubSpot configuration settings screen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/V_kqda49JVCEc2BMMh4jH-20260720-145610.png)

:::Paragraph{indent="1"}
You can have multiple instances of the same connector. For example, if you have marketing teams in separate regions, you can have more than one HubSpot connector, such as *HubSpot - Europe*, *HubSpot - US*, and *HubSpot - APAC*.
:::

4. Enter the **Connector Name** and HubSpot **Access Token** associated with your HubSpot account and click **Save**.

   :::hint{type="info"}
   **Note**

   The HubSpot connector now supports the [Private Apps](https://developers.hubspot.com/docs/api/private-apps) authentication and authorization option.
   :::
5. [Create a form](docId\:SR3I1aAJbh0TU85e6pNQk) on a page.
6. Click **All Properties** on the form.
7. Open the **Mappings** tab.
8. Select the **Contact** database to which you map the form fields from the **MA System Database** drop-down field.

   ![Selecting the HubSpot Contact database](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DWoTtrX7BDN6hoURzK97z-20260720-145610.png "Selecting the HubSpot Contact database")
9. Click **Publish**.
10. On the form, select **Edit** from a form field's context menu.
11. Open the **Extra field mappings** tab. The database option that you selected earlier displays.
12. Enable the database option and open the associated drop-down list to see the available fields. For example, if your form has a [Text](docId\:dGqSQKV0mgM33Efyrw9v5) field that was configured to capture an email address:

    1. Edit the email text field.
    2. Select the **Extra field mappings** tab.
    3. Select **Email** from the drop-down list to map the HubSpot database field to the **Email** field on the form.

    :::hint{type="info"}
    **Note**

    You can type in the field to show fields matching your entered string. In the following image, **email** was typed to show **email**, **owneremail**, and **saleforceemail** options (and not the other fields).
    :::

    ![Mapping a HubSpot database field to a form field](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/lCa8BreES62ENa7D4oIZT-20260720-145610.png "Mapping a HubSpot database field to a form field")
13. Repeat steps 10 through 12 for as many fields as you want to map.
14. Click **Publish**.

To test the mapping, go to your form on a published page, fill in and submit the form, and then go to your HubSpot provider to verify that the user is added to the HubSpot database.

## Retrieve contact data

When a visitor submits the form, the data is sent to HubSpot. To see who submitted the form, go to **HubSpot** > **Email** > **Email** to open the subscriber's screen, and choose **Subscribers** > **All Subscribers**.

## Personalize the form using a block

You can personalize a form to show only to a selected group.

**Video tutorial:** [Personalize content with Optimizely and HubSpot](https://episerver.wistia.com/medias/4ahpgqfsce). (2:34 minutes) See also [Set up audiences with personalization](https://support.optimizely.com/hc/en-us/articles/4413192423053).

For information about creating a visitor group and displaying information-based on a visitor group, see [Audiences](docId\:rodC2wlhTnWSmd-DJR2_y).

1. From the context menu on the form on the page, select **Personalize**. The **Large content area** dialog box appears.

   ![Personalize HubSpot form](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/IG4z0K9ghP5mPI_SHZNer-20260720-145610.png "Personalize HubSpot form")
2. Click **Everyone** and select a visitor group from the list. The following image shows personalizing the form to show only for people in the *VIP* visitor group.

   ![Personalize HubSpot form](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pmLTLpR9_iPRw7Hp5E1mG-20260720-145610.png "Personalize HubSpot form")

To create a visitor group for a HubSpot form, see [Create a visitor group for an MAI connector form](docId:0TrCDHzFBFPQnvrRj-Vka).