Sync leads from your lead ad forms to HubSpot
Last updated: October 4, 2024
Available with any of the following subscriptions, except where noted:
All products and plans |
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.
Before you get started
Before setting up your lead sync, do note the following:- 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.
- To turn lead syncing on for a specific page or ad account, select the checkbox next to the page or account name.
-
- 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.
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.