Please note: We recently updated our HubSpot integration. While we provide explanations for both the new and the legacy version, we strongly recommend using the new integration that does not require an API key.

Setting up the HubSpot integration (new)


  • All data that you want to map needs to have a System Label set (alternatively the field needs to be set as a variable)

  • Your flow needs to be published


  1. Within your heyflow, go to “Integrate” and then to the tab “Response Handlers”

  2. Click on “Connect to HubSpot”, a pop-up window will appear and ask you to provide your HubSpot credentials

  3. Once connected, you can start mapping your heyflow’s fields with corresponding HubSpot fields.

  4. And that’s it, you will now receive your responses within HubSpot!

Important to note:

  • The information from your heyflow will overwrite existing HubSpot data (in case a contact already exists)

  • Everything that hasn’t been mapped to a corresponding HubSpot field, will appear in the “Messages” tab within a HubSpot contact.

Legacy Integration

Go to your HubSpot account and head over to the settings. You can find the HubSpot settings in the upper right corner.

Click “Integrations” in the scroll-down menü on the left and head over to the API-Key section.

Copy your API-Key and head over to the Heyflow builder.

You might have to click on “show” right below your API-Key to make it visible. This is a safety measurement from HubSpot.

Click on “Integrate” and then on the HubSpot-Integration within the Heyflow builder.

Insert your API-Key and select “Contact” below.

It is important to name each variable of a block you want to pass information from to HubSpot according to our instructions. It will determine how data is stored within your HubSpot contact. Name the variable of the block designated to collect the first name ‘firstname’, for the last name ‘lastname’, and so on. The naming is also stated within the integration section of Heyflow or down below.

HubSpot/Contact Information

Block Variable Name

last name


first name


email address


phone number


company name


website URL


Head over to the building section within Heyflow.

Name every block variable according to the instructions.

Publish your Clickflow.

After successfully naming all relevant blocks, all submitted information like first and last name, email address, or company name are directly transferred to your CRM HubSpot into the corresponding contact.

All other information will be automatically transferred to HubSpot. You can find it in the property "Message" under "Contact Activity".

Did this answer your question?