Unified.to
All articles

How to Register your MetaAds OAuth2 application


March 4, 2026

  1. Create a Meta Developer account
    1. Go to https://developers.facebook.com/
  2. Create an application
    1. Go to https://developers.facebook.com/apps/creation/
      03cc19ca-b1b5-43fa-b858-37a6aeb9ab77.png

    b. Enter the following details:
     - **App Name**
     - **App Contact Email**
    
     ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_your_metaads_oauth2_application-1.png)
    
    
     ![Screenshot_2026-03-05_at_09.37.16.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_your_metaads_oauth2_application-2.png)
    

    c. Add the following use-cases; 'Manage ads using Marketing API' and 'Measure ad performance'
     ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_your_metaads_oauth2_application-3.png)
    
    1. Configure Permissions for the Marketing API

    a. Enable all permissions in the 'Create & Manage Ads' and 'Measure ad performance' use-cases
     ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_your_metaads_oauth2_application-4.png)
    

    Or
    b. After the application is created:
    1. Open the App Dashboard.
    2. Navigate to: Use Cases → Customize → Create & Manage Ads
      Screenshot_2026-03-05_at_09.42.12.png
    3. Open Permissions and Features.

    Enable the following permissions:
    • ads_management
    • ads_read
    • business_management
    • email

    Additional permissions such as:
    • pages_manage_ads
    • pages_read_engagement

    may also be enabled depending on your integration requirements.
    Screenshot_2026-03-05_at_09.44.57.png

4. Configure Facebook Login for Business

a. In the left sidebar, open (1, 2): Facebook Login for Business → Settings

![Screenshot_2026-03-05_at_09.49.45.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_your_metaads_oauth2_application-7.png)


b. Specify the [Unified.to](http://unified.to/) OAuth2 redirect URLs (3)


![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_your_metaads_oauth2_application-8.png)

c. Click Save Changes (4).

5. Configure App Domains

a. Go to (1, 2): App Settings → Basic

b. Add the following App Domains(3): unified.toapi.unified.toapp.unified.toapi-eu.unified.toapp-eu.unified.toapi-au.unified.toapp-au.unified.to

c. Scroll down and save the settings (4).

Screenshot_2026-03-05_at_10.05.24.png

In Unified https://app.unified.to/integrations/metaads, add the application's App ID (as the client ID) and the App secret (as the client secret). This information can be found in the App settings > Basic page.

You are now all set to authorize a MetaAds connection

All articles