Signup
 
  1. Help
  2. Advanced
  3. Integrations
  4. Integrate your typeform with HubSpot

Integrate your typeform with HubSpot

Connect a typeform to HubSpot, create or update contacts, companies, or deals, and send that data automatically to your HubSpot account when someone submits your typeform.

You can also map Hidden Fields, File Upload questions, quiz outcomes, and custom variables to HubSpot fields, and edit the integration in the Connect panel. For a full list of mappings supported by the integration, scroll down to the bottom of this article.

You can also check out this article about source tracking, or this one about personalizing your typeforms with HubSpot.

What you’ll need:

- A HubSpot account

- A free Typeform account

To jump to the section you're interested in, just click one of the following links:

- Set up the HubSpot integration

- HubSpot field types

Set up the HubSpot integration

To connect your typeform to HubSpot:

1. Open your typeform from your Workspace, or create a new one. I’ve chosen a short lead generation typeform for collecting people’s contact details.

HubSpot_01.png

2. Go to the Connect panel, and click Connect next to HubSpot.

Hubspot_02.png

3. Click Authenticate.

HubSpot_03.png

4. Select the account you want to use and click Choose account.

HubSpot_04.png

Note! You can associate multiple Hubspot accounts with your Typeform account. Any account you have previously connected will be listed here. Each unique typeform can be integrated with one Hubspot account: in other words, you can’t integrate the same typeform with multiple Hubspot accounts.

5. Start mapping your typeform questions to HubSpot fields by selecting them from the dropdown lists. 

HubSpot_05.png

You can use the dropdown list to scroll through options, or start typing in the search field to quickly find Typeform questions and matching HubSpot fields:

HubSpot_06.png

If you're mapping to an Email field, you can check the Yes, require an email address box to make sure that contacts will only be created if respondents provide a valid email address. If you leave the box unchecked, HubSpot might create records from typeform entries with missing, mistyped, or invalid email addresses. 

hubspotrequire.png

If you’re not mapping to an Email field, you can also use the checkboxes to select when to update existing contact information. In this example, the contact details will only be updated if the First Name and Phone Number fields match those of an existing contact.

HubSpot_07.png

If you also want to create a HubSpot form when someone submits your typeform, you must map your Contacts to HubSpot's Email field. You can use either your typeform's Email question or a Hidden Field for this mapping.

HubSpot_forms.png

6. Optionally, you can also map your Typeform fields to Companies...

HubSpot_08.png

7. ...or Deals in HubSpot.

HubSpot_09.png

The Winning Outcome field of a typeform is the Ending screen people will see at the end of a quiz based on their choices. 

HubSpot_10.png

In this example, the typeform includes a Yes/No question about signing up to a newsletter, and people will see a different Ending based on their response to this.

HubSpot_11.png

By mapping this to the Next step property in HubSpot, you can see who signed up to your newsletter, and as an example, add a new task to create a distribution list based on this information. 

HubSpot_12.png

You can also map your deals to a pipeline in HubSpot...

Screenshot_2022-06-07_at_12.11.56.png

...and select a deal stage from the dropdown list:

Screenshot_2022-06-07_at_12.12.43.png

This provides additional context and lets you segment your deals further on your HubSpot sales dashboard. To find out more about deal pipelines and deal stages in HubSpot, check out this article.

HC_Warning_ilu_cropped.png
Warning! Tracking the source of your typeforms in HubSpot requires additional configuration.

8. Toggle the switch to start tracking the source (direct, social) of your typeforms, and go to your HubSpot account dashboard to start filtering contacts by source properties. To track the source of embedded typeforms, follow the configuration instructions in our HubSpot source tracking guide (for advanced users).

HubSpot_source_tracking_toggle.png

9. Select the checkbox to send the existing responses of your typeform to HubSpot.

HubSpot_14.png

Here’s how sending existing responses to HubSpot works:

- The number of existing responses that can be sent to HubSpot is 1,000. If a form has more than 1,000 responses, only the 1,000 most recent responses will be backfilled.

- If an entry can’t be sent to HubSpot, for example, if a respondent enters an invalid email address, only that entry will fail, the other responses will be backfilled.  

- You can only send existing responses to HubSpot when you set up the integration, not when you edit it.

- Sending existing responses to HubSpot can take a few hours, depending on how many responses you’re trying to backfill and how many other users are backfilling at the same time.

- You can select a maximum  of three fields to update existing records, for example, First Name, Last Name and Email.

10. When you’re happy with your settings, click Save.

HubSpot_15.png

11. Now you’ll see that the integration is active in the Connect panel. You can untoggle the switch to deactivate it.

HubSpot_16.png

12. You can also click the three dots to Edit or Delete your integration.

HubSpot_17.png

When people submit your typeform, you’ll see the new Contacts, Companies, and Deals created in your HubSpot account:

HubSpot_19.png

Hubspot field types

Check which Hubspot fields are compatible with your typeform's questions here. Some question types are compatible with multiple field types:

Typeform question type Hubspot field type Notes
Multiple choice, Picture choice Multiple Checkboxes Only Multiple choice and Picture choice questions with Multiple selection set to true
Multiple choice, Dropdown, Picture choice Radio Select Only Multiple choice and Picture choice questions with Multiple selection set to false 
Multiple choice, Dropdown, Picture choice Select Only Multiple choice and Picture choice questions with Multiple selection set to false 
Number, Opinion scale, Rating, Score Number  
Yes/No, Legal Single Checkbox  
Multiple choice, Dropdown, Picture choice, Short text, Email, Hidden field, Date, Legal, Long text, Number, Opinion scale, Phone number, Rating, Website, Yes/No, Score, Quiz Outcome, Appointments Single-line Text Only Multiple choice and Picture choice questions with Multiple selection set to false 
Multiple choice, Dropdown, Picture choice, Short text, Email, Hidden field, Date, Legal, Long text, Number, Opinion scale, Phone number, Rating, Website, Yes/No, Score, Quiz Outcome, Appointments Multi-line Text Only Multiple choice and Picture choice questions with Multiple selection set to false 
Date Date  
File upload File  
"Other" option in Multiple choice questions Select Only Multiple Choice questions with Multiple selection set to false 
Matrix, Payment Not supported  

When creating custom properties in HubSpot, make sure to select the Use in forms, and bots checkbox, like in the screenshot below:

HS_EditProperty.jpeg

HC_Note_ilu_cropped.png
Note! Mapping to custom objects or 'Ticket' objects in HubSpot is not supported. You can only map to existing HubSpot properties with this integration, but new HubSpot properties will not be created.
HC_Note_new.png
Note! Mappings from Multiple choice or Dropdown question types to Checkbox or Dropdown HubSpot fields must match exactly, including HubSpot's label and internal value. This also applies to case sensitivity, for example, you can’t map option a, b and c from a Typeform question to a HubSpot field with option A, B, and C.

Tap into our community knowledge

Find Answers
Contact Support