Help Center / Apps / Hubspot

Hubspot

The Hubspot app enables editors and marketers to map Contentful entry content to custom modules in Hubspot, reducing busy work and the risk of errors. Custom Hubspot modules can be used across Hubspot email campaigns. Once the app is set up, updates made in Contentful are automatically reflected in Hubspot without needing to manually copy and paste content. 

hubspot-marketplace

Overview

  • Choose specific Contentful content types when you set up the Hubspot app. 

  • Select specific fields to sync to Hubspot modules. For example, fields such as: rich text, plain text, numbers, dates, media, and location. 

  • Rename HubSpot modules during setup to fit your workflow. 

  • Content dynamically and automatically syncs between Contentful and Hubspot once a field is connected. 

  • Accommodates localized Contentful fields. 

  • This app has a Contentful entry view and full page views, so that you can see an overview of all linked entries and fields.

Requirements

To use this app, you will need:

  • Space admin access to the Contentful space where you are installing the app. 

  • A configured Hubspot account. 

  • Access to generate a private app in Hubspot. 

Usage

Step 1: Install the HubSpot app

  1. Log in to the Contentful web app.

  2. Click Apps and select Marketplace.

  3. Search for and select the HubSpot app. The “App details” window is displayed.

  4. Click Install, the “Manage app access” window is displayed.

  5. Under “Environments,” select the environments where you want to install the app, click Authorize access.

To connect your organization's HubSpot account:

  1. In the Private app access token field, enter your HubSpot private app token.

    Hubspot-marketplace-app-token

  2. Click the dropdown for Instructions to create a private app token in HubSpot if you need guidance on where to generate it.

  3. The app will automatically create a content type named “HubSpot Config” and one entry under that content type. 

Step 2: Add HubSpot to a content type

The HubSpot integration only works with the content types you explicitly assign during setup.

To assign content types:

  1. In the “Content types” field, select one or more content types you want the HubSpot app to work with. NOTE: you can add the app to the entry sidebar by editing the content type field after the app has been installed.

  2. These assigned content types will display the HubSpot sidebar widget in the entry editor.

Step 3: Use the HubSpot app

After assigning content types, you're ready to sync individual entry fields with HubSpot.

hubspot-marketplace-entry-fields

To sync entry fields:

  1. Navigate to the “Content” tab and create or open an entry using one of the assigned content types.

  2. In the entry editor, locate the HubSpot widget in the entry sidebar, click Sync entry fields to HubSpot.

  3. Select the HubSpot module to map your content to.

  4. Choose which Contentful fields to sync. Supported field types include:

  • Rich text.

  • Short text.

  • Numbers.

  • Date and time.

  • Location.

  • Media.

Fields that are not accepted: 

  • Boolean.  

  • Json object.  

  • Reference.

  1. Optionally rename the module for clarity inside HubSpot.

  2. If your content is localized, select which locales you want to sync. There will be a dedicated field displayed for each locale enabled for the environment.

  3. Click Save mapping.

Step 4: Manage connected entries

You can review and manage all connected entries and their sync statuses:

  1. From the sidebar, click View all connected entries.

  2. Or, navigate to the “Apps” tab and open the HubSpot app full-page view.

Loading chat...