Integrating with HubSpot

Follow

Got HubSpot? Great! Just 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.
  • A paid Unbounce account.
  • 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

  1. In the Page Overview screen for the landing page, navigate to the Integrations tab, and from the list of Native Integrations, click HubSpothubspot.png

  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.

  4. If you have more than one account associated with your HubSpot login, choose an account you'd like to link back with Unbounce.
    Choose_an_Account.png

  5. Click Grant Access.
    Click_Grant_Access.png

  6. Wait for Unbounce to authenticate with HubSpot and redirect you back to Unbounce.
  7. Back in Unbounce, select the specific HubSpot form you wish to use with your Unbounce page and click Continue.
    Select_the_HubSpot_Form.png

  8. 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. 
  9. 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 that is 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!

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.