Facebook & Instagram Setup

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

1. Go to developers.facebook.com → My Apps → Create App
2. Choose "Business" app type
3. Enter an app name and contact email, then click Create App
4. In the app dashboard, go to Settings → Basic
5. Copy your App ID and App Secret
6. Under App Domains add promotiai.com; under Valid OAuth Redirect URIs add the callback URL shown in PromotiAI's setup modal

Step 2 — Connect in PromotiAI

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

Required Prerequisites

• A Meta Business Suite account
• Admin access to your Facebook Page and/or ad account
• Instagram Business or Creator profile linked to your Facebook Page

Permissions Requested

• pages_manage_posts — Create and publish posts on your Page
• pages_read_engagement — Read likes, comments, and shares
• ads_management — Manage ad campaigns (if ad account selected)
• instagram_basic + instagram_content_publish — Publish to linked Instagram account

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