Integrate New/Mode with HubSpot

This is a quick guide to syncing your New/Mode actions to HubSpot, from creating an integration in your organization to customizing field mapping on individual actions.

Adding a HubSpot integration to your Organization
Connecting your HubSpot integration with an Action
Syncing the fields on your Action to HubSpot:

     Syncing address data

Adding a HubSpot integration to your Organization

Before you begin, make sure you have:

• Your HubSpot Portal ID (Hub ID). Your Hub ID is visible in the upper right-hand corner of your screen when you're logged into HubSpot.
• A HubSpot form to associate with the action you'll be connecting to HubSpot.

1. Follow the steps to Create an Integration.
2. Once you have selected HubSpot as your CRM, you'll be asked to enter that Portal ID:

3. Click Save at the bottom of the page. 

You will be taken to your new Integration Setup page, where you'll be able to View or Edit it later:

Follow the Click here link in the prompt to establish or test your connect. You will be taken to your HubSpot account, or if your connection has already been established, you'll see a confirmation on your HubSpot service page:

You can always get back to this page to Edit or View your Integration Setup by clicking the link that is now visible under Integrations on the right-hand side of your Dashboard:

Connecting your HubSpot integration with an Action

1. In your New/Mode action, open the Edit tab, and scroll down to the Integrations section of the Basic Configuration page. Select your ActionKit integration from the 'CRM Integration' menu and click on 'Save & Next' to complete the process.
   
2. Once you have connected a specific action to HubSpot, you will be prompted to continue configuring your integration. Click the provide it here link:
   
   
3. You will be taken to a page titled Add new HubSpot API target. You will need to select the HubSpot form you want to be associated with your action, and you'll be able to select from a list of all your HubSpot forms:
4. Once you Save your new target, you'll be sent to your CRM Integrations page, which is always accessible through a action's Advanced settings dropdown menu. This page lists all the components of the campaign action you're working with.
5. On this page, you can also navigate back to your Add new HubSpot API target screen through the Edit HubSpot API link:

Syncing the fields on your Action to HubSpot

1. Start by opening Advanced > CRM Integrations to arrive at the Sync Settings page. On your CRM Integrations page, you'll see that only the email field has been synced automatically to the associated HubSpot form. 
   
   

   The Sync Settings page has three columns:

   Webform Component	HubSpot Field Name	Operations
   A list of the fields that supporters fill out on your action.	A list of the user fields in HubSpot where the data from your action will be sent.	Where you can edit your action's field to change the HubSpot field they're linked to.

   To map additional fields from your campaign action to HubSpot, click the Edit link to the right of the component/field name that you want to sync.
2. You'll be taken to the Edit Component page for the component you want to sync. Scroll down to the Send to HubSpot API dropdown menu, and select the HubSpot form field you want to be associated with that component:
   
   
3. Scroll down to the end of the page and click on the Save button to complete the process.
   

Syncing address data

Your HubSpot form should have address/street, city, state/province, zip/postal code, and country fields for address data to be synced correctly.

These fields should appear on the list of HubSpot fields that you can map data to:

Last updated: May 11, 2023