Sync leads from your lead ad forms to HubSpot

After connecting your Facebook, LinkedIn, or Google ad account to HubSpot, your existing lead ad campaigns will appear automatically on your HubSpot Ads dashboard. Sync leads from these lead ad forms to your HubSpot account. 

Please note: if you're syncing leads from your LinkedIn Ads accounts, please update your settings to use LinkedIn's new Lead Sync API by 16th February, 2025. If you've not updated your settings by then, your leads will stop syncing. 

Before you get started

• To set up your lead sync, you will need the following permissions:
  • Facebook pages: to set up lead syncing with your Facebook page, you will need ad account admin access, page admin access, and business manager leads access. Confirm that you have all the required permissions in Facebook.
  • LinkedIn ad account: to set up lead syncing with your LinkedIn ad account, you will need to be a Super admin, Content Admin, or Lead Gen Forms Manager for the associated LinkedIn Business Page. Confirm that you have the required permissions in LinkedIn.
  • Google ad account: to set up lead syncing with your Google ad account, you will need to be an admin in the ad account. Confirm that you have the required permissions in Google.
• When setting up a lead sync with your Google ad account, forms are synced at a campaign level. Lead ad forms in Google must be associated with an ad campaign in order to sync. 

Manage your lead sync settings

To ensure that historical and new leads from your lead ad campaigns sync with your HubSpot account, you must configure which pages or ad accounts you want to sync leads from. 

To manage your lead syncing settings:

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Marketing > Ads.
• At the top, click the Lead syncing tab.
• In the upper right, click Connect.
• In the dialog box, select your page's ad network.
• Configure your lead sync settings:
  • To turn lead syncing on for a specific page or ad account, select the checkbox next to the page or account name.
    • To sync leads from a Facebook page, you must select the page. Facebook pages will not automatically connect, even if managed within the same connected Facebook Ads account.

• • If your HubSpot account has access to marketing contacts, you can set your synced leads as marketing contacts. Toggle on the marketing contact switch to set contacts created as marketing contacts.
  • If you're syncing leads from a Facebook page or LinkedIn ad account, you can select a sync timeframe. Google will only sync leads after you turn lead syncing on for your account, and will not sync any historical leads.
    
    • New & recent leads: sync all leads from the last 90 days as well as new leads. 
    • New Leads: sync only new leads.

• Click Save. If you have any issues turning lead syncing on, or you see one of your pages or ad accounts disabled, learn how to troubleshoot lead syncing on Facebook, LinkedIn, or Google ad accounts.
  
  

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.

• This only applies to custom form fields, standard properties cannot be changed.
• Custom form fields must be less than or equal to 255 characters in length. If the field is longer than 255 characters, an error will display.
• Any changes to custom field mappings will only reflect on newly synced leads. Previously synced contacts will still retain the old field mappings.

To review and customize your mappings:

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Marketing > Ads.
• At the top, click the Lead syncing tab.
• 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 to map your custom field with.
  • Click Save.

Update your LinkedIn lead syncing settings to use LinkedIn's new Lead Sync API

If you need to update your settings, a banner will appear at the top of your ads tool: [Action needed] Authorize new LinkedIn API for lead syncing.

If you do not update your settings, your leads will continue to sync until 16th February, 2025. If you've already updated your lead syncing settings, the banner will not display. 

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Marketing > Ads.
• At the top, click the Lead syncing tab.
• In the LinkedIn section, next to the account you'd like to update, click Authorize lead sync. 
• In the pop-up box, click Allow. Your lead syncing settings will be updated. 
   

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. Review the errors to resolve any issues 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 address the issue. Learn more about how your lead ad fields map to HubSpot properties.