⭐ Available in the following bundle: Core Bundle (incl. in all plans)
⭐ Available on the following plans: Pro, Agency, Business
👀 Not sure which plan you're on? Check your subscription here.
HubSpot is a one of the most popular CRM tools, uniting marketing, sales, and customer service teams. Connect Heyflow with HubSpot to map your funnel fields to HubSpot properties and automatically track incoming Heyflow responses as Contacts, Deals, or Companies.
With Heyflow's native HubSpot integration, you can:
Hand off leads seamlessly from funnel to CRM
Use Heyflow’s native HubSpot integration to send submissions straight into HubSpot - no external tools needed and easy to set up.Capture clean, structured lead data in HubSpot
Create Contacts, Deals, or Companies from Heyflow submissions and map Heyflow fields (including Heyflow ID/Response ID/Referrer/URL or static text) to HubSpot properties.Create instant follow-up automation
Trigger HubSpot workflows right after a Heyflow submission to follow up quickly and personalize your sales and marketing activities.
Important to note
❗ All data that you want to map needs to have a System Label set (alternatively, the field needs to be set as a variable).
All unmapped information is displayed with each new Heyflow response in the activities timeline in the contact.
To see this, the Heyflow activity filter must be activated under Integrations.
❗ The information from your heyflow will overwrite existing HubSpot data (in case a Contact, Deal or Organization already exists)
Setup
Connecting your account
Within your heyflow, go to “Connect” and then to the tab “Response Handlers”
Click on “HubSpot” under CRM & Lead Management and "Add account", a pop-up window will appear and ask you to provide your HubSpot credentials. Before connecting the app, you'll be asked to agree use a third-party by installing this integration.
After authenticating with HubSpot, choose the HubSpot account you would like to connect to and click on “Select Account”.
Choosing the object
Select the HubSpot object you want to create as soon as a response is sent, between
Contacts,
Deals and
Companies.
❗ It's only possible to send the data to one of these object types, not multiple.
Mapping data fields
Choose a Heyflow field and map it to the corresponding field in your integration. You can select from:
built-in fields like Heyflow ID, Response ID, Referrer, URL (with parameters), or A/B test ID and version;
a static text input to send fixed values (e.g. an identifier that will only be sent to the integration);
or any input field from your flow.
Repeat this process for all relevant fields and click on "Connect" or “Save changes” afterward.
And that’s it, you will now receive your responses in HubSpot!
🔎 You can only forward individual file uploads, as each upload generates a single link. If you need to collect multiple files, you can add multiple Upload blocks to your flow. Learn more about Uploads here.
Troubleshooting
If something goes wrong with your integration, an automatic email notification will be sent. The message includes the flow ID, response ID and a description of the error returned by your integration.
🔎 For a list of common issues and general recommendations, check out the Troubleshooting Guide for Response Handlers.
VALIDATION_ERROR: Property values were not valid
Generally, the input value of the Heyflow field needs to always match the respective property value of the mapped HubSpot field.
You can get this error message, e.g. when there's a multiple choice option in Heyflow with a different option than provided in the property in HubSpot (e.g. when the type is dropdown select). The system label for the input option in Heyflow has to be the exact same as the internal value in HubSpot to be mapped correctly.
Also, you can get this error message if the response input is different from the property value, e.g. if only numbers are allowed but in your response is also text included.
I can't map a HubSpot multi-line text field
Currently, it’s not possible to map an input to a HubSpot multi-line field, though it can be mapped to HubSpot single-line text fields.
I only see one upload link, but a user can upload multiple files
You can only forward individual file uploads, as each upload generates a single link. If you need to collect multiple files, you can add multiple Upload blocks to your flow. Learn more about Uploads here.
Tracking
URL Parameters
If you want to pass URL/UTM parameters from your flow to HubSpot, you need to set up a hidden input field to capture the data. Once set up, you can map these input fields to corresponding fields in your response handler of choice.
The UTM parameters will then be automatically passed along with each response—without your visitors noticing. 🚀
Original Source Tracking
Source properties provide information about the origins of your contacts. In this context, the Original Source property reveals the initial source through which a contact engaged with your business.
🔎 Please note: Per default, the property Original Source is set to Offline Sources.
In order to receive individual information, just as in the case of URL parameters, we need to use hidden input fields and variables. First, you need to know which source you would like to track with your flow. The property Original Source is provided by HubSpot directly and can't be edited. Therefore, you can choose from the following list:
This internal value is also the input you need to have in your flow, in order to map it with HubSpot, e.g. PAID_SEARCH. You can set it as prefilled content in a hidden input field, so it's automatically filled in.
💡 Tip: If you have different sources, from which a user can access your flow, simply use the values in your flow URL and erase the prefilled content. Take a look here for more information.
How to Trigger a Workflow
To automatically trigger a HubSpot contact workflow based on Heyflow submissions, follow these steps:
Map the Heyflow ID to a HubSpot property
In your integration settings, make sure that the Heyflow ID is mapped to a contact property in HubSpot.
This allows you to identify which specific flow a contact submitted.
Create a new workflow in HubSpot
Go to Automation → Workflows → Create workflow.
Choose Contact-based workflow.
Set up the enrollment trigger
Click Set enrollment triggers → Heyflow → Has completed: Heyflow Submitted (Contact).
Add a filter for the specific Heyflow ID (the property you mapped earlier) if you want the workflow to trigger only for a specific flow.
(Optional) Handle multiple flows with one workflow
If you prefer a single workflow for all flows, you can omit the ID filter and use a branch inside the workflow to act differently based on the mapped Heyflow ID.
How to remove HubSpot from Heyflow
There are two different ways of removing HubSpot from Heyflow:
Removing a HubSpot integration on funnel level
In your funnel in the HubSpot's integrations settings, you can easilyPauseor evenDeletethe integration.
Disconnect your HubSpot account
In your Heyflow account settings under Integrations, you can click onManage Accountsand thenRemove accountto disconnect your account completely.
You can also do so in HubSpot directly. In your HubSpot account, click the settings icon in the top navigation bar. In the left sidebar menu, navigate to Integrations > Connected Apps. Click Actions on the Heyflow app, then click Uninstall.
❗ Please note: if you are removing your HubSpot account, all HubSpot integrations are removed from your funnels and no data will be sent from your funnels to HubSpot anymore.