Settings

Meta app credentials, AI keys, and how to connect owned Instagram pages.

API controls

Master switches. Off blocks live calls everywhere — local data stays readable.

External API

RapidAPI is mocked (IG_API_MOCK). Live scrape is skipped; simulated data feeds Analyze / generate.

Meta API

Official Graph API: connect owned pages and publish.

Instagram / Meta

App credentials live in env. Connect owned pages under Pages. Publishing uses the official Graph API only.

Loading…

Instagram Login does not need a Facebook Page. Page-linked accounts can still use Connect with Meta; those uploads can go through the Facebook Page. Instagram Login Reels need PUBLIC_BASE_URL as an HTTPS tunnel.

Loading…

Meta Developer setup

Official Graph API only. Until App Review, only Facebook users listed as app Admin / Developer / Tester can connect.

Convert each destination Instagram account to Professional (Business or Creator) in the Instagram app. A Facebook Page is optional.
Create a Business type app at developers.facebook.com. Add the Instagram product (API setup with Instagram login). Copy the Instagram App ID and Instagram App Secret from that page — not the Facebook App ID under Settings → Basic. Using the Facebook ID causes “Invalid platform app”.
Instagram → API setup with Instagram login → Business login settings → OAuth redirect URIs (not Facebook Login). Paste http://localhost:3000/api/meta/ig-oauth/callback exactly. If Meta appends a trailing slash, set META_IG_REDIRECT_URI to that slashed URL. Optional Facebook Login URI: http://localhost:3000/api/meta/oauth/callback.
Instagram Login permissions: instagram_business_basic, instagram_business_content_publish, instagram_business_manage_insights.
Optional — for accounts already linked to a Facebook Page, keep Facebook Login for Business and permissions pages_show_list, pages_manage_posts, instagram_content_publish.
App Dashboard → Roles: add Instagram testers (Instagram Tester, not only Facebook Tester). They must accept the invite in Instagram → Settings → Apps and websites. Paste META_IG_APP_ID, META_IG_APP_SECRET, META_APP_ID, META_APP_SECRET, and META_IG_REDIRECT_URI into .env.local, then restart npm run dev. Instagram Login Reels need PUBLIC_BASE_URL (HTTPS tunnel).
Tokens last ~60 days — reconnect from Pages → Connect when a card shows expiry. App Review is required before non-role users can use the app Live.
Graph publishing is capped around 50 posts / IG account / 24h. FrameLab defaults to 8/day per page.

AI generation keys

Required for autopilot media (captions can fall back without a key).

OPENAI_API_KEY — captions + DALL·E images

FAL_KEY — optional Flux images and AI Reels video. Without it, Reels still publish: a 5s vertical MP4 is built from the generated still (needs ffmpeg).

OPENAI_VIDEO_MODEL — optional (default sora-2) if your OpenAI key has Videos API access.