Open navigation

How to create a personal Facebook app

These steps will guide you through how to set up your own Facebook app to use with the Supermetrics Facebook Ads data source. Apps like these help resolve errors that can result from large or complex queries, including job failed or invalid Facebook response

About Facebook personal apps

A Facebook app that you ask us to connect to your Supermetrics account provides your data with its own connection to the Facebook Ads API. This means that you're not sharing the quota used by other Supermetrics users who are also pulling data from Facebook Ads.

Nothing will change in how you query Facebook Ads with Supermetrics. The only difference is that you'll no longer see quota-related errors like job failed or invalid Facebook response.

And if one app is connected to multiple Pages, there won’t be any shared access or data between these Pages. This means you can create one personal app and use it with multiple teams and Pages safely.

Before you begin

To create an app, you need to have a Facebook developer account. Log in to the Facebook developer site with the Facebook user you use with Business Manager to get started.

Additionally, all Facebook users that are logged into the connector will need a Facebook developer account, and they will need to be assigned to the app in Business Manager's settings. 

Once you've created the app, you should open your Business Manager page, click the People tab, and then add the developer accounts to the app. Set their permission level to Manage App when you assign them.  

One personal app is enough for your whole Supermetrics team. If you have several users in your team, create one personal app and assign all of them to it.

Login review

During setup, Facebook will show a warning that reads "Submit for Login Review". To keep the setup process moving as quickly as possible, we advise against submitting the permissions for review. There's no way to estimate how long Facebook's review will take if you do choose to submit for review. Learn more about our data privacy policies.


Set up a personal app
  1. Log into Business Manager.
  2. Click the gear icon in the lower left corner.
  3. Click the Accounts dropdown, and then click Apps.
  4. Click Add, and then Create a New App ID.
  5. If prompted, select Manage integrations for your business. Click Next.
  6. Under Select an app type, choose Business. Click Next.
  7. Fill in a Display name and App contact email. 
  8. Click Create App.
  9. In the next screen (Dashboard), navigate to add the Facebook Login card. On this card, click Set Up.
  10. Click the Facebook Login dropdown menu on the left side of the screen. Select Settings.
  11. In the Valid OAuth Redirect URLs field, enter this URL:

  12. Click Save changes.
    Red arrows point to the "Facebook Login" option in the main toolbar for the app dashboard, and then "Settings". Another red arrow points to the text box for "Valid OAuth Redirect URLs" where the Supermetrics login URL should be pasted.

  13. Click Dashboard in the left-side menu. In the Marketing API card, click Set Up.
  14. Click the Settings dropdown under Dashboard in the left-side menu. Select Basic.
  15. Copy the App ID and App Secret. Send them to us in a new support ticket, or reply to the original thread we contacted you through.

    Red arrows point to the "App ID" and "App Secret" text fields under Settings->Basic. These will need to be copied and provided to the support team for the next steps.

  16. After our support team adds your credentials to your team, you’ll need to reauthenticate the data source to start using your own app. (If you're using Google Sheets, please do this through GS instead of Supermetrics team site.)

Complete step 16 for all Facebook users that are logged into the connector. Remember to also assign all other Facebook users to the app in Business Manager settings. The Facebook users who haven't reauthenticated will continue to use the original version and have original quota limitations.


Custom conversions and custom actions might not be recognized right after you implement this solution. Errors like "error":"(#100) c_action_######... are not valid for fields param. can occur.

Solve this error by reauthenticating one more time (note that it can take a few hours after reauthentication for the error to disappear). Learn how to reauthenticate Facebook Ads in Supermetrics.

Feature unavailable

If you encounter an error beginning with Feature unavailable, it often means that the account trying to log in hasn’t been added to the app.

Follow these steps to add the user and resolve the issue:

  1. Log into Facebook Business Manager.
  2. Click the gear icon.
  3. Click the Accounts dropdown in the left-hand menu.
  4. Click Apps, and select your app.
  5. Navigate to the People tab, and click Add People.
  6. Select the people you’d like to add. Enable Manage App access for each of them

Did you find it helpful? Yes No

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