Facebook & Instagram Setup

PromotiAI uses a Bring Your Own App model for Meta. You create a Facebook Developer App to get an App ID and App Secret, then authorize PromotiAI to access your Page and ad account. Once connected, AI-generated content publishes immediately when you click Publish Now.

Step 1 — Create a Meta Developer App

Go to developers.facebook.com → My Apps → Create App
Choose "Business" app type
Enter an app name and contact email, then click Create App
In the app dashboard, go to Settings → Basic
Fill in Privacy Policy URL and Category — Meta won't serve the login dialog for an app with these blank
Copy your App ID and App Secret
Under App Domains add promotiai.com; under Valid OAuth Redirect URIs (in the "Facebook Login for Business" product settings) add the callback URL shown in PromotiAI's setup modal

Add yourself as Administrator — skip App Review entirely

You do not need Facebook App Review to manage your own Page or ad account. In the app, go to App Roles → Roles and add your personal Facebook account as Administrator or Developer. Once added, every permission below (pages_manage_posts, ads_management, etc.) is pre-authorized for your account instantly, with zero review or waiting. App Review is only required when people outside your app's roles need to connect — for connecting your own business, leaving the app in Development mode is fine indefinitely.

Create a Login Configuration — required, not optional

This is the single step that decides whether login works at all. In Facebook Login for Business → Configurations, click Create configuration, select every permission PromotiAI needs (pages_show_list, pages_read_engagement, pages_manage_posts, pages_manage_metadata, pages_messaging, ads_management, ads_read, business_management), save, then copy the Configuration ID.

⚠️ Skipping this step doesn't produce a helpful error — every login attempt returns an opaque "Feature Unavailable — Facebook Login is currently unavailable for this app" page that names nothing missing. If you hit that error, this is almost always the cause.

Step 2 — Connect in PromotiAI

Go to Settings → Integrations in your workspace
Click the Facebook / Instagram card
Choose Quick Setup (paste App ID + App Secret + Configuration ID from the previous step, click Connect) or Step-by-Step Guide (guided walkthrough with screenshots)
A Meta OAuth popup opens — log in with the account that owns your Page/ad account
Grant the requested permissions and select the Pages and ad accounts to sync
Click Confirm — the integration activates immediately

Required Prerequisites

A Meta Business Suite account
Admin access to your Facebook Page and/or ad account

Permissions Requested

pages_show_list — Discover the Pages you manage
pages_manage_posts — Create and publish posts on your Page
pages_read_engagement — Read likes, comments, and shares
pages_manage_metadata — Needed for comment/reaction sync
ads_management, ads_read, business_management — Manage ad campaigns and business assets (if an ad account is selected)

This connects your Facebook Page only. To publish to a linked Instagram Business or Creator profile, connect Instagram separately from the Instagram card on the Integrations page — it uses its own OAuth flow and permissions (instagram_business_basic, instagram_business_content_publish, and related scopes).

Instagram uses its own App ID/Secret, not Facebook's

Instagram Business Login is a separate product added to the same Meta App as Facebook, but it issues its own App ID and App Secret — pasting your Facebook credentials into the Instagram card will fail to connect.

In the same Meta app from Step 1, go to Add Product (or Add use cases on newer apps) → find Instagram → Set Up
Open the Instagram product page → "API setup with Instagram Login"
Copy the Instagram App ID and Instagram App Secret shown there (not the ones under Settings → Basic — those are Facebook's)
Add the Instagram callback URL under this same page — it's a separate list from Facebook's redirect URIs
Paste the Instagram-specific App ID/Secret into the Instagram card's Quick Setup on the Integrations page

Troubleshooting

Ensure you have Admin (not Editor) role on the Page
Disable browser ad blockers during the OAuth popup
Verify the callback URL in your Meta app exactly matches the URL shown in PromotiAI
If the token expires, re-connect from Settings → Integrations and re-authorize
Instagram connect fails with "Invalid platform app"? Either the Instagram product/use case hasn't been added to the Meta app yet, or Facebook's App ID/Secret was pasted instead of Instagram's own — see the Instagram setup steps above

Facebook & Instagram Setup