Open navigation

How to create a personal Facebook app

These steps will guide you through how to set up your own Facebook app, which you can use with the Supermetrics Facebook Ads data source.

If we haven't reached out to you specifically about this feature, but you're interested in testing it out, please contact us. We'll be happy to help you get started.

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 account you use with Business Manager.

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

All users in your team will need a Facebook developer account, and they will need to be assigned to this app on the app settings. Once you've created the app, you should open it in Business Manager, click the People tab, and then add the user's developer account(s) to the app. Set their permission level to Manage App when you assign them.  

Login review

During this process, Facebook will show a warning titled "Submit for Login Review". This is expected. We advise that you not submit the permissions for review by Facebook, as doing so will delay the process. You can submit them, but we have no way to estimate how long Facebook's review will take. Learn more about our data privacy policies.


  1. Log in to Business Manager.
  2. Go to Business Settings (the gear icon):

    Image shows main tool bar in the Facebook Business Manager, with a red arrow pointing to the cog 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. (Skip if not applicable), select Manage integrations for your business. Click Next.
  6. Under Select an app type, choose Business. Click Next.
  7. Fill Display name (could be anything) and App Contact Email. Click Create App.
  8. In the next screen, find the Facebook Login card. On this card, click Set Up.
  9. Click the Facebook Login dropdown menu on the left side of the screen. Select Settings.
  10. In the Valid OAuth Redirect URLs field, enter this URL:

  11. 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.

  12. Click Dashboard in the left-side menu. In the Marketing API card, click Set Up.
  13. Click the Settings dropdown under 'Dashboard' in the left-side menu. Select Basic.
  14. Copy the App ID and App Secret. Send them back to us through a new ticket ( or the support ticket 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.

  15. After our support team adds your credentials to your team, you’ll need to reauthenticate your data source to start using your own app.
  16. Remember to do the previous step, step 15, for all users in the team. Remember to also assign all other users to the app in settings. The users who haven't re-authenticated 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 (it can take a few hours after reauthenticate for the error to disappear). Learn how to reauthenticate the data source with Supermetrics in Google Sheets.

Did you find it helpful? Yes No

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