Open navigation

Facebook Ads: Authentication and reauthentication guide

This guide will walk you through how to authenticate or reauthenticate Facebook Ads with Google Sheets, Data Studio, and Microsoft Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API. 

Before you begin

To connect Supermetrics to Facebook Ads, you need:

  • Employee access with the View performance option enabled in an ad account, or Ad account analyst access to an ad account.
  • For Lead data access, your account must either be a Lead manager or a Page admin.
  • Agencies must have Page admin access. 
  • If you’re using the New Pages Experience, you need partial access to the linked Facebook account.

Visit Facebook’s help center to learn more about adding permissions and controlling who can access your leads

Here’s an example of sufficient user permissions:

Data protection agreement

If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Navigate to ExtensionsSupermetricsLaunch to open the Supermetrics sidebar.
  3. Under Data source, select Facebook Ads.
  4. Click Start.
  5. A Facebook login page will open. Enter your credentials, and click Log in. (If you're already logged in to Facebook in the browser, click Continue with Facebook.) 
  6. Click Continue as to authenticate with that user account.
    If you wish to authenticate with a different user account, click Log in to another account.
  7. You will be prompted to hand-pick your Pages. You can skip this step as Facebook Ads is for accounts only, not pages. 
  8. Click Done
  9. Click Ok to complete the authentication steps.
  10. Under Select accounts, select the accounts.


Learn how to reauthenticate the data source with Supermetrics in Google Sheets.

Next steps

Learn how to create your first Supermetrics query with Facebook Ads.


  • If you're missing a Facebook account, follow these steps.
  • For error: Two Factor Authentication Required, follow these steps.
  • If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide
  • If you encounter a permission error such as “user permission denied” or similar, follow this guide.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.