Integrating with HubSpot

Follow

Got HubSpot? Great! Follow the instructions below, and you can send your new Unbounce leads over to HubSpot.

Note:

This integration is for HubSpot Marketing Hub, and not HubSpot CRM. If you would like to integrate with HubSpot CRM, you may need to integrate with Zapier or set up a Webhook.

What You’ll Need:

  • An active HubSpot account with administrative access.
    • If you're not the administrator of your HubSpot account, ask someone who is to follow these steps.
  • A new HubSpot form (older HubSpot forms have been deprecated and are NOT compatible with the new HubSpot API).
  • Your Hub ID.
  • An Unbounce account with an active subscription.
  • An Unbounce page you want to integrate with HubSpot.

Estimated time to complete: 3-5 minutes.

The Unbounce/HubSpot integration works on a per-form basis, which means that your Unbounce landing page can only be integrated with a single HubSpot form at a time.

Setting Up Your HubSpot Integration

Check out the video below on how to set up a HubSpot integration:

Pro Tip:

You can use these setup steps to integrate your popups and sticky bars with Hubspot. See Setting up Integrations With Popups and Sticky Bars to learn more.
  1. In the Page Overview screen for the landing page, navigate to the Integrations tab, and from the list of Native Integrations, click HubSpot:
    select-hubspot-from-integrations-list


  2. Click Connect with HubSpot:
    Click_Connect_with_HubSpot.png

  3. HubSpot will prompt you to log in if you aren't logged in already:
    hubspot-login-page

  4. If you have more than one account associated with your HubSpot login, choose an account you'd like to link back with Unbounce:
    select-a-hubspot-account

  5. Wait for Unbounce to authenticate with HubSpot and redirect you back to Unbounce.
  6. Back in Unbounce, select the specific HubSpot form you wish to use with your Unbounce page and click Continue:
    choose-a-hubspot-form-to-connect-with-unbounce

  7. Once the integration is set up, you can adjust the field mapping settings, so your form fields in Unbounce will map to the designated fields in HubSpot. 
  8. Be sure to republish your page by clicking the Republish button at the top right corner of the Page Overview, and you're all set. All new leads will now be sent over to your HubSpot account!

For more information about mapping your form fields in Unbounce to HubSpot, take a look at your documentation: Setting Up Field Mapping.

Important: HubSpot's Custom Javascript

When you integrate with HubSpot, we add some custom Javascript that allows leads to be properly tracked via HubSpot. The Javascript is titled HubSpot Tracking Script and should not be removed under any circumstances. You will need to re-integrate with HubSpot if you remove the HubSpot custom Javascript!

HubSpot uses a tracking script inserted into your Unbounce page, and as a result, you'll need to republish your pages after integrating with HubSpot to finalize the changes. 

Troubleshooting

Error: Bad Request

HubSpot has a Captcha option available in their forms. If you are using our integration and notice your leads are coming back with a 'bad request' error, try switching the Captcha option off on HubSpot's end. (See "How do I use CAPTCHA on my HubSpot form?" for more details!)

Forms Are Required

Our HubSpot integration requires at least one form in one of your page variants. Any time another page variant with a form is created, the integration needs to be re-run.

If none of your page variants has a form, you will see a warning when you try to integrate with HubSpot, and you will not be able to continue. Simply create a form in one of your variants, and then you can proceed.

If one of your page variants does not have a form (but at least one other page variant does), then you will see a warning when you try to integrate with HubSpot. Heed this warning carefully! If you add a form to any of your other page variants, then you will have to redo your HubSpot integration for the new page variant form to work with HubSpot correctly!

More leads in HubSpot than appearing in the Unbounce Leads Table

Hubspot has a feature that captures non-Hubspot form entries, in other words, from your Unbounce form. However, this feature does not contain any form of validation.

For example, if your Unbounce form contains validation rules that only allow for valid phone numbers, and your page visitor submits an invalid number, Unbounce will display a validation error message.

However, HubSpot will still capture and record the form submission from the page visitor with the invalid phone number, leading to more submissions in HubSpot than Unbounce. 

To remedy this, switch off the Collect data from website forms feature in HubSpot: Enable or disable non-HubSpot forms. This will prevent invalid submissions from passing through to HubSpot as well. 

Summary

If, for any reason, your page is missing the HubSpot Cookie form field or the HubSpot Tracking Script Javascript, then the integration with HubSpot will not work. To fix this, simply re-add the HubSpot integration.

Glossary

HubSpot Integration: requires an Unbounce account with a Pro subscription. It works on a per-form basis so your Unbounce landing page can only be integrated with a single HubSpot form at a time.

Hub ID: can be found on your HubSpot Settings page.

HubSpot Tracking Script: should not be removed under any circumstances.