Skip to main content
Business verification and App Review are the steps you need to complete to get and maintain access to user and business data. Until both are done, the app can only access assets owned by people who hold a role on it.

​
Create a Meta app

Meta issues the App ID and App Secret when you create an app in the Meta for Developers portal.

1

Sign in to Meta for Developers

Sign in to your Meta for Developers account.

  • Click Continue with Facebook and sign in with the Facebook account that will own the app.
2

Start a new app

On the Apps page, click Create App.

Meta for Developers Apps page with the Create App button highlighted
3

Name the app and set the contact email

On the App details step, enter a name in App name and check the address in App contact email.

  • App name — the name shown on your My Apps page and associated with your app ID, for example StackOne Integration. You can change it later in Settings.
  • App contact email — the address Meta uses to contact you about policies, app restrictions, or recovery if the app is deleted or compromised.
  • Click Next.
Create an app App details step with the App name and App contact email fields highlighted
4

Select the Facebook Login use case

On the Add use cases step, select Authenticate and request data from users with Facebook Login, then click Next.

  • Selecting this use case greys out the use cases that cannot be combined with it on the same app.
Add use cases step with the Authenticate and request data from users with Facebook Login card highlighted
5

Choose a business portfolio

On the Business step, answer Which business portfolio do you want to connect to this app?, then click Next.

  • Select the verified business portfolio that will own this integration. Connecting a verified portfolio is what gives the app access to third-party user and business data.
  • You can select I don’t want to connect a business portfolio yet. and add one later, but verification is required before the app can access that data.
  • Click Create a business portfolio. if you do not have one yet.
Business step with the portfolio list and the no-portfolio option highlighted
6

Create the app

Review the Publishing requirements step, click Next, then check the Overview summary and click Create app.

  • Business verification — verify your business as a business entity in order to access user data through Meta’s APIs.
  • App Review — complete all required data usage, data handling and data protection questions, then submit for App Review.
  • Meta opens the new app’s dashboard once it is created.
Create an app Overview step with the Create app button highlighted

​
Add the StackOne redirect URL

StackOne completes the OAuth flow on a fixed callback URL, and Meta only redirects to URLs listed on the app.

1

Open the Facebook Login settings

In the left sidebar, open Use cases, click Customize on the Facebook Login use case, then select Settings.

2

Add the redirect URL

Add the Callback URL from your Connector Profile to Valid OAuth Redirect URIs, then save the page.

Facebook Login settings with the StackOne callback entered in the Valid OAuth Redirect URIs field

​
Copy the app credentials

The App ID and App secret identify your app to StackOne.

1

Open the basic app settings

In the left sidebar, open App settings, then click Basic.

2

Copy the App ID and App secret

Copy both values from the top of the page.

  • App ID — the public identifier of your Meta app. Paste it into the App ID field in the StackOne Connector profile.
  • App secret — the secret half of the app credentials, hidden behind Show. Click Show, copy the value, and paste it into the App Secret field in the StackOne Connector profile.
  • The App secret can create an app access token that acts on behalf of any user of the app, so store it securely and never include it in client-side code.
App settings Basic page with the App ID, the masked App secret, and the Show button highlighted

​
Grant the permissions the integration needs

Meta requests permissions from the person connecting the account during the login flow, so there is nothing to enable inside the app for them.

1

Select the permissions to request

Enables actions: Create Ad, Create Ad Creative, Create Ad Set, Create Business System User, Create Campaign, Create Comment, Create Custom Audience, Create Lead Gen Form, Create Page Album, Create Page Photo, Create Page Post, Create Page Video, Create Pixel, Delete Ad, Delete Ad Creative, Delete Ad Set, Delete Campaign, Delete Comment, Delete Custom Audience, Delete Photo, Delete Post, Delete Video, Get Ad, Get Ad Account, Get Ad Account Insights, Get Ad Creative, Get Ad Insights, Get Ad Set, Get Ad Set Insights, Get Album, Get Business, Get Campaign, Get Campaign Insights, Get Comment, Get Custom Audience, Get Lead, Get Lead Gen Form, Get Me, Get Page, Get Page Insights, Get Photo, Get Pixel, Get Post, Get Post Insights, Get User, Get Video, List Ad Accounts, List Ad Creatives, List Ad Sets By Account, List Ad Sets By Campaign, List Ads By Account, List Ads By Ad Set, List Business Client Ad Accounts, List Business Owned Ad Accounts, List Business System Users, List Campaigns, List Custom Audiences, List Lead Gen Forms, List Leads By Ad, List Leads By Form, List My Accounts, List Page Albums, List Page Feed, List Page Photos, List Page Posts, List Page Settings, List Page Videos, List Pixels, List Post Comments, List System User Assigned Users, List User Accounts, List User Businesses, Update Ad, Update Ad Account, Update Ad Set, Update Campaign, Update Comment, Update Custom Audience, Update Page, Update Post

The Permissions field in the StackOne Connector profile sets the permissions requested during login. Leaving it blank requests the connector’s default set, which does not include leads_retrieval or pages_manage_ads, so enter the permissions explicitly if the integration retrieves leads.

​
Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.