Instagram Setup

Set up Instagram Business API integration for publishing content, managing comments, and viewing insights through Fp Switchboard.

Prerequisites

• Instagram Business or Creator account
• Facebook Page connected to your Instagram account
• Access to Meta for Developers

Setup Steps

1. Create a Meta App

   Go to developers.facebook.com and create a new app. Select “Business” type.

2. Add Instagram Graph API

   In your app dashboard, click “Add Product” and select “Instagram Graph API”.

3. Add Redirect URI

   Under Facebook Login > Settings, add:

   https://api.switchboard.fpdigital.ai/oauth/instagram/callback

4. Request Permissions

   Add the required permissions:

   • instagram_basic
   • instagram_content_publish
   • pages_show_list
   • pages_read_engagement

5. Copy Credentials

   From Settings > Basic, copy the App ID and App Secret.

Environment Variables

npx wrangler secret put INSTAGRAM_CLIENT_ID
npx wrangler secret put INSTAGRAM_CLIENT_SECRET

Redirect URI

https://api.switchboard.fpdigital.ai/oauth/instagram/callback

Common Issues

Business Account Required

The Instagram Graph API only works with Business or Creator accounts linked to a Facebook Page. Personal accounts are not supported.

• No Instagram account found: Ensure your Instagram account is converted to Business/Creator and linked to a Facebook Page.
• Permission denied: Instagram permissions require Meta app review for production use. Development mode works with test users only.
• Media upload limits: Instagram has daily limits on content publishing. Check Instagram’s current rate limits.
• Image requirements: Photos must be JPEG format and meet Instagram’s minimum resolution requirements.

Testing

1. Connect from the Switchboard Dashboard
2. Authorize with your Facebook account (which connects to Instagram)
3. Click Test Connection to verify
4. Try: “Show my recent Instagram posts”