Integration: HubSpot

This guide provides step-by-step instructions to connect your HubSpot account to Flow, so customers are created and kept up to date as HubSpot contacts.

Time required: 15 minutes

User role: Administrator

Module: Integrations

Overview

The HubSpot integration creates a contact in your HubSpot account when a customer is created in Flow, and updates the contact when the customer changes their details. Contacts are matched on email address, so a customer who is already in HubSpot is updated rather than duplicated.

Optionally, changes to a contact's first name, last name or phone number in HubSpot can be sent back to the matching customer in Flow.

Before You Start

The following will need to be completed before connecting HubSpot:

Prerequisite Details
✅ A HubSpot account Your organisation's own HubSpot account
✅ Permission to install apps in HubSpot The person connecting must be a Super Admin in HubSpot, or have the App Marketplace Access permission
✅ Administrator access in Flow Required to manage integrations
✅ HubSpot custom properties (optional) To sync extra Flow fields, create the matching contact properties in HubSpot first, under Settings > Properties

Note: If HubSpot is not listed under Third-Party Integrations in Flow, contact OpenPlay support to enable it.


Steps

1. Connect HubSpot in Flow

  1. Go to System Configuration > Data streams > Integrations > Third-Party Integrations
  2. Select HubSpot
  3. Click Connect
  4. Sign in to HubSpot if asked, and choose the HubSpot account to connect
  5. Review the access requested and click Connect app

The integration asks to read and write contacts, and to read your contact properties so you can map fields. It cannot see deals, companies, emails or other HubSpot data.

2. Configure the New Customer Workflow

This workflow creates a contact in HubSpot when a customer is created in Flow.

  1. In the HubSpot integration settings, open New Customer
  2. Map Flow fields to HubSpot (optional): Choose which HubSpot contact property each Flow field should fill. Email, first name, last name and phone number are always sent and do not need mapping
  3. Toggle the workflow on

3. Configure the Customer Updated Workflow

This workflow keeps the contact up to date when a customer changes their details in Flow.

  1. Open Customer Updated
  2. Map Flow fields to HubSpot (optional): Use the same mapping as New Customer, so the same properties stay up to date
  3. Toggle the workflow on

Note: Without this workflow enabled, HubSpot keeps whatever details a customer had when they were first created.

4. Send HubSpot Edits Back to Flow (Optional)

This workflow updates the customer in Flow when their first name, last name or phone number is changed in HubSpot.

  1. In Flow, create an API key with the purpose FLOW API. See How to create FLOW API Keys
  2. In the HubSpot integration settings, open Contact Updated in HubSpot
  3. Flow API key: Paste the key
  4. Toggle the workflow on

Important: Flow API keys have an expiry date. When the key expires, HubSpot edits stop reaching Flow. Create a new key and paste it into this setting before the old one expires.


What Data is Synced?

Direction What syncs
Flow to HubSpot Email, first name, last name and phone number, plus any Flow fields you map
HubSpot to Flow First name, last name and phone number only
  • Contacts are matched on email address
  • Email addresses are never changed in Flow, because they are the customer's login
  • A blank value in HubSpot never clears a value in Flow
  • HubSpot edits only update Flow when exactly one Flow customer has that email address. Contacts that did not come from Flow are left alone
  • Each side skips the update when the other already matches, so one change does not bounce back and forth
  • Marketing preferences are not synced. Manage subscriptions in HubSpot

Result

New customers appear as contacts in HubSpot within a few minutes of being created in Flow, and their details stay up to date as they change.


Troubleshooting

The connection fails when installing the app in HubSpot?
The person connecting needs to be a Super Admin in HubSpot, or have the App Marketplace Access permission. Ask your HubSpot Super Admin to connect, or to give you the permission.

A customer has not appeared in HubSpot?
Customers without an email address are skipped, because HubSpot matches contacts on email. Add an email address to the customer in Flow, and the contact is created when the customer is next updated, if Customer Updated is on.

A mapped property is empty in HubSpot?
Check the property exists in HubSpot and accepts the kind of value Flow sends, for example a text property for a text field. Then check the mapping in both New Customer and Customer Updated.

A change made in HubSpot has not reached Flow?
Check that Contact Updated in HubSpot is on, the Flow API key has not expired, and the change was to first name, last name or phone number. Only one Flow customer can have the contact's email address.

A customer changed their email address and now appears twice in HubSpot?
Contacts are matched on email address, so a new email address creates a new contact and leaves the original in place. Merge the two contacts in HubSpot.


What's Next?

Was this article helpful?
0 out of 0 found this helpful