Skip to content

Sync leads from your lead ad forms to HubSpot

Last updated: November 4, 2021

Applies to:

All products and plans

After you connect your Facebook, Google or LinkedIn ad account to HubSpot, your existing lead ad campaigns will appear automatically on your HubSpot Ads dashboard. To ensure that both historical and new leads from your lead ad campaigns sync with your HubSpot account, you'll need to configure which pages or ad accounts you want to sync leads from in your ads settings in HubSpot.

Please note:

  • Before connecting your Facebook page, confirm that you have all the required permissions in Facebook. If you're enabling lead syncing for your LinkedIn ad account, confirm that you have the required permissions in LinkedIn.
  • Facebook and LinkedIn store leads from lead ads for 90 days after creation. When you connect your ad account to HubSpot, these leads will be synced to HubSpot, along with leads generated going forward. Google will only sync leads from after you turn lead syncing on for your account, and will not sync any historical leads.


To manage your lead syncing settings:

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Marketing > Ads.
  • Click the Lead syncing tab.
  • In the upper right, click Connect.
  • Select your page's ad network:
    • Facebook: to turn lead syncing on/off for a specific page, select/clear the checkbox next to the page name. 
    • LinkedIn and Google: to turn lead syncing on/off for an ad account, select/clear the checkbox next to an ad account name.
  • Click Save.

If you have any issues turning lead syncing on, or you see one of your pages or ad accounts disabled, check out the lead syncing troubleshooting guide for Facebook or LinkedIn. If you encounter issues when setting up lead syncing for your Google ad account, follow the steps in the Google ad account connection troubleshooting guide.

Necessary disclosure: if you select a Facebook page, Google ad account, or LinkedIn ad account to sync leads from, HubSpot will receive webhook updates when a new lead form submission occurs on the connected page or ad account. HubSpot will pull all lead submissions for connected pages and ad accounts, and will log them as form submissions in the CRM.

Configure custom field mappings and review form submissions

You can review synced forms and customize the mappings between any custom form field and the associated HubSpot property.

  • In the Lead syncing tab, click the page name.
  • In the right panel, under Forms, locate and click a form.
  • To change a custom field mapping:
    • Hover over the custom field and click Edit mapping.
    • Click the HubSpot property dropdown menu, then select a new HubSpot property that you want to map your custom field to.
    • Click Save.

Please note:

  • Standard properties cannot be changed.
  • Any changes to custom field mappings will only be reflected on new leads that are synced with HubSpot. Previously synced contacts will still have the old field mappings.



Fix lead syncing errors

If HubSpot detects issues with any of your connected pages or their associated forms, you'll see an alert on your Ads dashboard so you can resolve the problem and minimize potential disruptions to your lead syncing.

  • In your HubSpot account, navigate to Marketing > Ads.
  • If there are any problems with your lead ad forms, an alert will appear at the top of the page. Click View errors to navigate to your lead syncing settings.


  • Locate the page that lists a form error,  then click the page name.
  • In the right panel, under Forms, click the form name of the form that needs to be fixed.
  • Under the Status column of the Field mappings table, hover over the error to see details about the issue and how to resolve it.
  • If the error is due to an issue with a field mapping, click Edit mapping to update the custom field mapping and resolve the issue.


Learn more about how your lead ad fields map to HubSpot properties.

Was this article helpful? *
This form is used for documentation feedback only. Learn how to get help with HubSpot.