How to configure Instragram for Openquok
Overview
You can connect a professional Instagram account in two ways: Instagram (Business) uses a Facebook Page linked to that Instagram account; Instagram (Standalone) uses Instagram Login directly (no Facebook Page).
Both require a Meta for Developers app. The sections below are Openquok-specific URLs and envs.
One Meta app
Backend environment
Openquok reads credentials only through backend/config/GlobalConfig.ts. Set:
Instagram (Business) — Facebook Login
- FACEBOOK_APP_ID
- FACEBOOK_APP_SECRET
Instagram (Standalone) — Instagram Login
- INSTAGRAM_APP_ID
- INSTAGRAM_APP_SECRET
Copy from backend/.env.development.example into backend/.env.development.local, then restart the backend.
The frontend base URL used in OAuth redirect URIs comes from FRONTEND_DOMAIN_URL (default http://localhost:5173 for local Vite). For non-HTTPS local URLs, the backend uses the same HTTPS relay pattern as other Meta integrations (see the Threads doc).
OAuth redirect URIs (register in Meta)
Meta redirects the browser to your web app after consent. Register these exact paths on top of your frontend origin (from FRONTEND_DOMAIN_URL), for example:
Instagram (Business) — Facebook Login for Business
https://YOUR-FRONTEND-DOMAIN/account/integrations/social/instagram-businessInstagram (Standalone) — Instagram Login
https://YOUR-FRONTEND-DOMAIN/account/integrations/social/instagram-standaloneFor local HTTPS (or relay) examples, mirror the pattern used for Threads in Meta Threads.
Meta app setup (summary)
Create a Meta app
Create an app in Meta for Developers.
Select use case
Select Other.
Select app type
Select Business.
Finish Creating Meta App
Business Verification Needed
Instagram (Business) flow
When your professional Instagram account is already tied to a Facebook Page, you can connect to it by setting up the Login for Business flow.
Add Facebook Login for Business
In dashboard, select Facebook Login for Business
Set Redirect URI
Add the Instagram (Business) redirect URI from the OAuth redirect URIs (register in Meta) section to your app’s valid OAuth redirect list.
Request permissions
In the Meta developer app, open the permissions area where you can request advanced access (wording varies—for example Use cases → Permissions and features, or App Review). Request access for the scopes below; they match what Openquok’s Instagram (Business) integration asks for during OAuth.
- instagram_basic
- pages_show_list
- pages_read_engagement
- business_management
- instagram_content_publish
- instagram_manage_comments
- instagram_manage_insights
Dashboard differences
Copy your credentials
In the Meta app Settings area, copy App ID → FACEBOOK_APP_ID, and App Secret → FACEBOOK_APP_SECRET to your env file.
Restart the backend. Otherwise, the backend may not pick up your new environment variables.
Instagram (Standalone) flow
Use Instagram (Standalone) when you prefer Instagram Login for a professional account and do not want to route the connection through a Facebook Page or Facebook Login for Business.
Warning
Add Instagram product
In dashboard, select Instagram
Set Instagram Business Login
This will let you to provide a redirect URL.
Set Redirect URI
Add the Instagram (Standalone) redirect URI from the OAuth redirect URIs (register in Meta) section to your app’s valid OAuth redirect list.
Copy your credentials
Copy Instagram app ID → INSTAGRAM_APP_ID, and Instagram app secret → INSTAGRAM_APP_SECRET to your env file.
Restart the backend. Otherwise, the backend may not pick up your new environment variables.
Add Role and Start testing
Add People
Go to App Roles page and click “Add People”
Add the Instagram account as Tester
Under additional roles for this app, select Instagram Tester.
Enter the Instagram username that should test the app (often your own).
Accept Invitation
You should see a pending invite on Instagram’s manage access page.
Accept it to finish tester setup for that account.