Integrate Formidable Forms with your HubSpot account with the HubSpot WordPress plugin. Add and update Contacts in your HubSpot CRM account from the data submitted from your WordPress forms.

Get a Free HubSpot Account

You can send data to any custom property in HubSpot. Custom properties allow you to save extra data that isn't standard in HubSpot.

Download and install

1. If you haven't already, install and activate the current version of Formidable Forms Pro on your WordPress site.
2. After confirming your Formidable Forms license, proceed to the Formidable → Add-Ons page and toggle on the HubSpot WordPress plugin.
   

Set up Formidable for HubSpot forms

Choose your method for HubSpot authentication between OAuth or Private App Access Token.

Use OAuth integration

If you are dealing with Public apps, we recommend using OAuth integration. Learn more about HubSpot OAuth integration.

1. Click to toggle Connect with OAuth, then click the Connect to HubSpot button to complete the connection.
   
2. Connect to your HubSpot account. Once you have logged in, select your account name and click the Choose Account button.
   
3. To complete the connection and allow Formidable Forms to access to your HubSpot account, click the Connect App button.
   
4. If the HubSpot API has been successfully authorized, you will see this popup message. Click the Dismiss to continue.
   
5. You are all set to create your HubSpot forms! The Disconnect HubSpot button should show on the page to indicate that the authorization was successful.
   

Use private app access token

Private app access token is another way to get authenticated. The OAuth integration is for Public apps, while the private access token is for Private apps. Learn more about HubSpot Private Apps.

To integrate with HubSpot using a Private app access token, follow the steps below:

1. Log in to your HubSpot account and click the Settings icon in the main navigation bar.
   
2. In the left sidebar menu, go to Integrations → Private Apps.
3. Click the Create a private app button.
4. On the Basic Info tab, configure the details of your app by entering a name, logo, and description.
   
5. On the Scopes tab, choose the Read or Write checkbox for each scope that you want your private app to have access to.
   
6. Once you are done setting your private app, click the Create app button at the top right of the screen.
7. In the popup box, click the Continue creating button. Using the app's access token, you can now create API calls.
   
8. Go back to your WordPress dashboard. In the Formidable → Global Settings → HubSpot page, paste your HubSpot Private App Access Token in the field provided.
   
9. Click the Update button to save your settings.

Create a HubSpot form

Now that your WordPress site is connected to HubSpot, it's time to create your HubSpot forms.

1. If you haven't already created a form to collect contacts, create a form now.
2. Go to edit the form you will be linking to HubSpot. Go to the Settings → Actions & Notifications tab for this form and click on the HubSpot icon.
   
3. This will give you the mapping settings for your HubSpot form. The HubSpot forms plugin will automatically fetch all the fields. Be sure to select a form field for each required HubSpot field.
   
   If you haven't already connected your HubSpot account, you can also do it here.
   
4. Save the changes and submit an entry in your form. After submitting an entry, you should see a new contact listed in HubSpot.

Linking to checkbox, radio, or dropdown field

When linking to a checkbox, radio, or dropdown field in Hubspot, the saved value in the field must be identical to the internal value in Hubspot.

Linking to date field

When linking to a date field in HubSpot, follow the steps below.

1. Add a Hidden field to your form. It must be a Hidden field, not a text or similar field types.
2. Add a numeric calculation in the Default Value (Calculation) box. Replace 100 with the ID or key of the Date field.

   ([100] - 1) * 86400000

   Read more about numeric calculations.

3. In your HubSpot form action, map the hidden field you created in the form to the HubSpot date field.

Using custom properties

When using custom properties in HubSpot, they will only appear in the Hubspot form action list if they have been added to the Contact Information group. If it is under a different group, you can do the following:

1. Go to your HubSpot account and click to edit the custom property details.
2. In the Basic Info tab, select Contact Information from the Group dropdown field.
   
3. In the Field type tab, select the checkbox that says Use in forms, and bots.
   
4. Go to your form Settings → Actions & Notifications and click on the HubSpot form action. Click the Clear Cache button to reset the list options.

GDPR contact deletion

With OAuth integration, GDPR contact deletion is supported. It means that when a contact is deleted from HubSpot, that email will also be deleted in the client website. Learn more about performing a GDPR delete in HubSpot.

Limitations

• The Hubspot add-on doesn't currently support two-way sync. The information is one-way from Formidable to Hubspot.
• File URLs can be passed to HubSpot, but the files are not sent.
• Currently, HubSpot API doesn't support listing the company lists.

Troubleshooting

No options in the form action

When a HubSpot form action is added, it should include a dropdown filled with all the possible HubSpot lists. If this dropdown is empty, there might be a connection error between your site and HubSpot.

1. Go to the Formidable → Global Settings page and click the Update button. Do you see an error message about your HubSpot API key?
2. If the API key is correct, and no error messages appear, return to the HubSpot form action and click the Clear Cache button.
3. Install the Formidable Logs add-on from the Formidable → Add-Ons page to check for any error messages. After installing, you will find your logged form actions on the Formidable → Logs page. Click on any logged action to see more detail.

Missing lists in form action

Every list may not show in the form action settings. There are a couple reasons why a list may be missing.

1. The list was created after Formidable last fetched them. Click the Clear Cache button to reset the list options.
2. The list is not set as a static list. HubSpot does not allow new contacts to be added to active/dynamic lists.

Missing entries in the form

If the leads are showing up in your HubSpot account, but the entries are missing from your Formidable form, you might have the HubSpot native plugin installed on your site. You can choose to disable this plugin entirely and only use Formidable Hubspot or go to your HubSpot account settings to disable collecting data from non-HubSpot forms.

INVALID_LONG error

The INVALID_LONG error message relates to how HubSpot expects the date format. The date field stores the data in the YYYY-MM-DD format. Before sending the data, you must convert the date to UNIX formatted timestamps in milliseconds. Follow the steps to set the date field properly in your form.

Read more about how timestamps should be formatted for Hubspot APIS.

Related developer hook

• Disable GDPR contact deletion with the frm_hubspot_webhook_deletion.