Meta configuration.
Instapaid uses Meta's official Instagram API with Instagram Login. These steps happen in the Meta Developer dashboard — the app cannot do them for you.
Mode
DEVELOPMENT / TEST
Credentials
Configured
META_APP_ID · META_APP_SECRET · META_REDIRECT_URI
Requested scopes
- instagram_business_basic
- instagram_business_manage_insights
Callback URL to register in Meta
/api/public/instagram/callback
The same value must be saved as META_REDIRECT_URI. Register the preview URL for testing and the published URL for production. The older /api/instagram/callback path still redirects here, but this is the canonical one.
Instagram login must be opened outside an embedded preview window — Instagram blocks its authorization page inside iframes. Open the app in its own browser tab before connecting.
Automatic token refresh
10 days before expiry
TOKEN_REFRESH_THRESHOLD_DAYS
Automatic data sync
every 24 h
INSTAGRAM_SYNC_INTERVAL_HOURS
Create a Meta Developer app
developers.facebook.com → My Apps → Create App → type “Business”.
Add the Instagram product
In the app dashboard add Instagram, then open “Instagram → API setup with Instagram login”.
Configure Business Login for Instagram
Set up “Business login settings”; copy the Instagram app ID and Instagram app secret.
Set the OAuth redirect URI
Add exactly the callback URL shown below under “Business login settings → Redirect URIs”.
Request the permissions
instagram_business_basic and instagram_business_manage_insights. Nothing more.
Add Instagram test users
App roles → Roles → Instagram testers; accept the invite inside the Instagram app settings.
Test authentication
Sign in to Instapaid, open the dashboard and press Connect Instagram.
Request Advanced Access
App Review → Permissions and features, for both Instagram permissions.
Complete App Review
Submit a screencast of the login and insights flow.
Add production credentials
Switch the app to Live mode and use the production redirect URI.