Skip to content
ads

Troubleshoot issues when syncing leads from your Facebook pages to HubSpot

Last updated: August 30, 2022

Ad blockers may block some of the content on this page. To prevent this, pause your ad blocker while browsing the Knowledge Base.

Applies to:

All products and plans

After connecting your Facebook Ads account to HubSpot, your existing lead ads in Facebook will automatically appear on your ads dashboard. To sync leads from your Facebook pages to HubSpot, the user who connected your account must have the required permissions.

Confirm your permissions and settings in Facebook Business Manager

Facebook allows you to configure permissions on your page, business manager, and the HubSpot Ads integration when you first connect your ad account. To ensure you can connect your page for lead syncing, confirm all of the following settings.

Facebook ad account connection

In order to sync leads from your Facebook pages, you also have to connect at least one Facebook ad account to HubSpot. You will need to be an admin of the ad account you connect.

After connecting your ad account, confirm that lead syncing has been enabled for the page in HubSpot:
  • 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. Then, in the Facebook section, review the connect pages. 
  • If the Facebook page is not displaying, try connecting the page:
    • In the upper right, click Connect.
    • In the dialog box, select Facebook.
    • Select the checkbox next to a Facebook page to turn lead syncing on.
    • Click Save.

Facebook page admin access

The Facebook user that you use to connect your ad account must be an admin in the pages you want to sync leads from. To confirm that you're an admin of a page:

  • Go to your Facebook Business Settings. If you have access to multiple Facebook Business Managers, select the business manager that your page is owned by.
  • In the left sidebar menu, under the Accounts section, click Pages.
  • Select the page that you want to sync leads from.
  • In the right pane, click the name of your Facebook user to see all of your page permissions.
  • Confirm that the Manage Page permission switch is toggled on.

troubleshoot-lead-syncing-manage-page-new-ui-1

Facebook business manager asset settings

The connected Facebook ad account and any pages you want to sync leads from must be in the same business manager:

  • Confirm the business manager of a connected ad account:
    • Navigate to your Facebook Business Settings. If you have access to multiple Facebook Business Managers, select the business manager that your page is owned by.
    • In the left sidebar menu, click Ad accounts.
    • Click on an ad account you've connected to HubSpot.
    • In the right pane, under the ad account name, confirm that the business manager name matches the business manager name of any pages that you want to sync leads from.

troubleshoot-lead-syncing-ad-account-check-new-ui

  • Confirm the business manager of a page that you want to sync leads from:
    • Navigate to your Facebook Business Settings. If you have access to multiple Facebook Business Managers, you’ll need to select the business manager that your page is owned by.
    • In the left sidebar menu, click Pages.
    • Click on a Page that you want to sync leads from.
    • In the right pane, under the page name, confirm that the business manager name matches the business manager name of your connected ad accounts.

troubleshoot-lead-syncing-page-check-new-ui

Facebook business manager leads access

The Facebook user you use to connect your ad account must have Leads Access for any pages you want to sync leads from. By default, all page admins have Leads Access, but if you or another Facebook user in your business enabled Leads Access manager, individual users might be assigned different levels of access.

To confirm that you have Leads Access:

  • Navigate to your Facebook Business Settings. If you have access to multiple Facebook Business Managers, you’ll need to select the business manager that your page is owned by.
  • In the left sidebar menu, click Integrations, then click Leads Access.
  • Click on a Page that you want to sync leads from.
    • If a business manager has not enabled Leads Access manager, this screen will be greyed out and disabled, and your Facebook user already has Leads Access.
    • If a business manager admin has enabled Leads Access manager, check that the name of your Facebook user is under the People tab.

troubleshoot-lead-syncing-leads-access-new-ui-1

 

HubSpot Ads Integration permissions

When you first connect your Facebook ad account to HubSpot, Facebook prompts you to authorize the following permissions. If you choose to revoke any of these permissions, the HubSpot Ads integration will not work correctly.

  • Manage ads for ad accounts that you have access to
  • Manage your business
  • Access leads for your Page
  • Read content posted on the Page
  • Create and manage ads for your Page
  • Manage accounts, settings and webhooks for a Page
  • Read user content on your Page
  • Show a list of the Pages you manage.

To confirm whether you've authorized the correct permissions for the HubSpot Ads integration from your Facebook account:

  • Navigate to Facebook and sign into an account that you've connected to HubSpot.
  • In the top menu bar, navigate to Settings.
  • In the left panel, click Business integrations.
  • Under Active Business Integrations, locate HubSpot Ads. Then, click View and Edit.
  • Confirm that all app permissions are toggled on. If you authorized specific pages when you first connected your Facebook ad account to HubSpot, ensure that each page is listed beneath each app permission.

Ensure the page has been enabled

If you have multiple Facebook business pages, it's possible that the right ones aren't enabled for lead syncing. If you aren't able to enable certain pages, check your app and page permissions first. Follow these steps to ensure that you’ve enabled all of the proper pages for lead syncing in HubSpot:

  • Identify the ads that are not syncing leads. Take note of any ads that have never synced leads to HubSpot.
  • Find the ad in Facebook: 
    • Log in to your Facebook Ad Manager.
    • Click the ad campaign and ad set to find the particular ad or ads that aren't syncing leads to HubSpot.
  • Check the page associated with the ad: 
    • Click the Edit option next to the ad.
    • In the Conversion section, Facebook will display the business page associated with the ad.



Check your report filters

Depending on which attribution report you've selected in the ads dashboard, some synced leads may not display. For example, the First form submission attribution report will only show synced leads who first became contacts by filling out a lead ad form. The report will not show a synced lead if they filled out a lead ad form after they already submitted a form on your website.

Marketing Hub Professional and Enterprise customers can use the All form submissions attribution report to see all leads that have synced from their lead ads. If you have a Starter or Free account and you want to see all synced leads for an ad, you can create a list using the Ads Interactions filter.

Reconnect your page

If you connected your Facebook page but didn't have Leads Access in your Facebook business manager, leads from your page will not sync to HubSpot. Once you gain Leads Access, any new leads will sync to your HubSpot account, but you will need to reconnect your page to sync any historical leads.

To reconnect your page:

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to MarketingAds.
  • Click the Lead syncing tab.
  • Hover over the Page you want to reconnect, then click Disconnect.
  • In the dialog box, click Disconnect.
  • In the upper right, click Connect.
  • In the dialog box, select Facebook.
  • Select the checkbox next to the Facebook page you want to reconnect.
  • Click Save.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.