Tassos Marinos Developer of Joomla Extensions

How to connect Convert Forms with HubSpot

Published in Convert Forms
Updated 29 Nov, 2019

Convert Forms offers seamless integration with the HubSpot email marketing service. Connecting Convert Forms to your HubSpot forms is surprisingly easy. Follow our step by step guide on how to connect Convert Forms with HubSpot below.

1. Addon Installation

  • Navigate to Components > Convert Forms > Addons
  • Click the Cog button for the HubSpot Addon. A popup will appear where you can enable the addon.

hubspot convert forms addon

  • Click on the Status and select Enabled.
  • Now you can click on Save & Close button to save the enabled addon.

convert forms update plugin status

2. Campaign Setup

To setup a Campaign with HubSpot, follow the steps below.

hubspot campaign convert forms

  • Navigate to Components > Convert Forms > Campaigns
  • Create a new Campaign by clicking New
  • Type a name for your Campaign. This name can not be seen by anyone else but you.
  • For the Sync Leads > Choose Service selectbox choose HubSpot. If you can not find the HubSpot option then you do not have the HubSpot Addon installed and activated. In that case, please go back to the top of the article and see how to install the mandatory addon.
  • Save the Campaign for the HubSpot API Key field to show up.

HubSpot API Key

To obtain your HubSpot API Key you need to log into your HubSpot Account, click on the top right on your Name > Profile & Preferences, Select Integrations from the left menu sidebar > API key. Once you are there, you will be able to create an API Key and copy it as shown in the screenshot below.

hubspot api key

Now that you have the API Key, go ahead and paste it back into the Campaign settings you were setting up previously in Convert Forms.

Finally, now that you have the HubSpot API Key, you can Save & Close this Convert Forms Campaign.

3. Email & Name Fields


For a Convert Form to successfully store an email address to your HubSpot account it needs to have an email field. This field is already set up at the time of creating the form and you don't have to change its input value as it is already configured for you.

convert forms email field


HubSpot offers by default one field specifically for the contact's first name. To use that field you should create a field named firstname. See the screenshot below to understand where to set it up.

hubspot first name

You can use this field as a fullname option as well but we recommend that you create a field named lastname to store your contact's last name. If you would like to store more name-related fields like middle name you need to create the field through your HubSpot account. This way you would be creating essentially a custom field. See next how to use HubSpot's custom fields with Convert Forms.

4. HubSpot Custom Fields

HubSpot offers custom fields to collect more types of data for each of your contacts. We can also use these custom fields in a Convert Form for a more efficient data gathering and by extension, a more efficient campaign. Furthermore, HubSpot already provides a wide collection of fields that you can use to characterize your contacts. Let's see where to find them and how to use them.

4a. Find the HubSpot fields

First you need to navigate to your HubSpot Account, click "Contacts" in your HubSpot Account's main menu and then click "Actions" > "Edit Properties".

hubspot custom fields

In the Properties Screen you can see all the fields that can be used already. To use any of these fields you need to find its internal name. To do that, click on any of them, on the popup sidebar that will appear, click on the </&dt; Icon next to the name to reveal the internal name. Then copy the internal name from the popup window as seen below:

hubspot custom field name

4b. Create a custom HubSpot field

Apart from the already available HubSpot fields, you can also create fields of your own. To do that follow the steps below.

  • Click the "Create property" button at the top right of your screen.

hubspot new custom field

Type the label of the field and click Next.

hubspot new custom field setup

Select the field type. Convert Forms can accommodate all of the field types listed there apart from the File Upload type and the Datepicker type. Click Create to save the property.

hubspot new custom field setup

4c. An example Convert Form with HubSpot custom fields

As you can see in the screenshot below we have setup an example Convert Form using HubSpot's custom fields. In this example we use HubSpot's city field and an age field which we created through HubSpot.

hubspot custom fields city

hubspot custom fields age

5. Assign form to Campaign

Of course don't forget to assign the form to our newly created Campaign! See the screenshot below to understand where to assign it.

hubspot convert forms assignment