Facebook OAuth 2.0 connector profile – StackOne setup guide

Sign in to your Meta for Developers account.

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

On the Apps page, click Create App.

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.

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.

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.

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.

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

Add this value to Valid OAuth Redirect URIs, then save the page.

• https://api.stackone.com/connect/oauth2/facebook/callback
• Use Strict Mode for redirect URIs is on by default, so the URL must match exactly. Add it without a trailing slash.
• Enforce HTTPS is on by default and the StackOne callback is already an https URL.

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

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.

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.