HubSpot Integration

Send Submission Data to Your HubSpot Contacts and Properties

Adrian avatar
Written by Adrian
Updated over a week ago

Available on

❌ Free

❌ Basic

βœ… Pro

βœ… Business

You can add participants automatically to your HubSpot contacts or update their properties using the native HubSpot integration.

If you want to test the integration before committing to a paid plan, you can do so by registering for a free 14-day trial.

Not entirely sure how to set up the integration? Make sure to learn about it in our dedicated article first.

Connecting the Integration

You can connect the integration either by navigating to the "Integrations" tab in the navbar or by opening the dropdown menu of your project's card and selecting "Connect" - then just click "Connect" on HubSpot's card.

You will then be asked to select a HubSpot account to connect to involve.me as shown on the below example:

Once you've chosen an account, you'll need to grant access to involve.me so it can connect to it.

After granting access, you'll be able to see the email address of the HubSpot account that you're using.

Data Mapping for the HubSpot Integration

The integration will send email and default properties automatically.
For your list to accept more data, please add "Custom properties" on HubSpot accordingly beforehand.

Once the integration has been connected to your project, you'll find the button "Manage Custom Fields" on the project's integration settings, which is where you can map the involve.me fields to the integration fields.

Default Custom Fields That Are Already Predefined by HubSpot

  • Email

  • Title

  • Gender

  • First name

  • Last name

  • Job title

  • Organization name

  • Phone

  • Mobile phone

  • Street

  • Zip

  • City

  • State

  • Country

  • Fax

  • Website

Default Custom Fields That Need to Be Created Beforehand

If you want to receive data for the below fields, then you'll need to create them in HubSpot exactly as shown in the column "HubSpot Fields".

involve.me Fields

HubSpot Fields

Type

Outcome

outcome

Single line text

Project

involveme_project

Single line text

Country Code

country_code

Single line text

Full birthday with year

birthdate

Date picker

Correctly answered questions

correct

Number

Quiz score of values

score

Number

Total points for the determining outcome

outcome_points

Number

Calculator result*

calculator

Number

Calculators by ID (eg. ca_xxxxxxx)**

ca_xxxxxxx

Number

Url for the website where the project was embedded

embed_url

Single line text

Remote id

remote_id

Single line text

Facebook

facebook

Single line text

Twitter

twitter

Single line text

Instagram

instagram

Single line text

Linkedin

linkedin

Single line text

*This is the result of the first calculator in the project, if there's only one calculator you can use this field.

**If you have multiple calculators in your project you can specify them by ID.

Data From Question Elements

Any other collected data fields (eg. from multiple choice elements, free text inputs, sliders, opt-in checkboxes, etc,) can be mapped through "custom field mapping".

Good to Know

  • If you want to set your contacts as marketing contacts in HubSpot, then make sure to read the following article to ensure everything's correctly set up: https://knowledge.hubspot.com/integrations/manage-marketing-contacts-settings-for-your-integrations

  • Make sure you choose the right field names & types or your integration may not work (eg. can't save a text as a date property, or a text as a number).

  • Custom properties on existing contacts will be updated when the same email is sent again.

  • If you have configured a HubSpot integration on a project and you duplicate said project, your integration settings will duplicate as well.

Opt-in Checkbox and GDPR

In order to be fully GDPR compliant, you will need to tick the option "Only trigger integration when opt-in checkbox element was selected" on your integration's settings and add a dedicated opt-in checkbox that sends data over to the integration, from your involve.me project.

Here's a step-by-step guide on how to set it up.

If GDPR is of no concern to you, then you can skip this step.

Testing Your Integration

Once the integration has been set up and connected to your project, it will be time to test it in order to ensure everything is working as intended, learn how to do it here.

If you still have any questions, please feel free to contact our support team.

Did this answer your question?