Platforms
Connect Instagram
You create your own small app at Meta. It stays in Development mode: only you use it, so Meta doesn't need to review it. Publit.Si then posts with your own keys.
You need
- A Cloudflare tunnel
- An Instagram account you can switch to Professional
- A Meta (Facebook) login for developers.facebook.com and business.facebook.com
Make the account Professional
In the Instagram app: Settings → Account type and tools → Switch to professional account (Creator or Business). Posting through the API only works for professional accounts.
Add the account to a business portfolio
Open business.facebook.com and create a business portfolio, or use yours.
Settings → Accounts → Instagram accounts → Add → sign in to your Instagram account.
Create the Meta app
Open developers.facebook.com → Create app.
- 1:Manage messaging & content on Instagram
Use case: Manage messaging & content on Instagram, and connect the business portfolio from the step before. The app can stay in Development mode.
Use cases → Customize → API setup with Unified login.
Create the login configuration
Facebook Login for Business → Configurations → create one from the template Instagram API (Unified Login).
Token: System-user access token, expiration Never. Asset: Instagram accounts.
Permissions: keep the ones in the table below. Remove ad accounts and the ads and messages permissions – Publit.Si needs none.
A permission isn't offered? Add it to the use case first: Use cases → Manage messaging & content on Instagram → Customize → Permissions and features → Add next to it. Then open the configuration again and tick it.
| Permission | Needed? | What it does |
|---|---|---|
instagram_content_publish | Required | Posting. Publit.Si refuses the connection without it. |
instagram_basic | Required | Meta grants publishing only together with it |
instagram_manage_insights | Optional | Views and reach (INSTAGRAM_INSIGHTS=1) |
instagram_manage_comments | Optional | Reading and answering comments (INSTAGRAM_COMMENTS=1) |
business_management | Optional | Lets Publit.Si find the shared account by itself; without it you often need the account ID (next part) |
Set the redirect URI
Meta: Facebook Login for Business → Settings → Valid OAuth Redirect URIs → paste it → Save changes.
Enter the keys
Copy the App ID and the App secret from App settings → Basic, and the ID of the configuration from the step before.
Enter them in Publit.Si under Settings › Platform setup › Enter credentials, or in
.env:INSTAGRAM_UNIFIED_APP_ID=… INSTAGRAM_UNIFIED_APP_SECRET=… INSTAGRAM_UNIFIED_CONFIG_ID=… INSTAGRAM_INSIGHTS=1 INSTAGRAM_COMMENTS=1- 1:Client ID
- 2:Save and apply
.envfor you and restarts the services. Secrets are never shown again.
If Meta doesn't name the account
With a system-user token Meta often doesn't tell which Instagram account you shared. Publit.Si then says so when you connect. Give it the account's ID once:
Meta Business Suite → Settings → Accounts → Instagram accounts → your account: copy its ID (digits only).
Set it in
.env, restart and connect again. Publit.Si checks the ID against your login.INSTAGRAM_UNIFIED_ACCOUNT_ID=17841400000000000
Older app: API setup with Instagram login
In your app: Use cases → Customize → API setup with Instagram login. Only apps created before late October 2026 have it.
Add these permissions:
instagram_business_basicandinstagram_business_content_publish. For views and reach alsoinstagram_business_manage_insights, to read comments in Publit.Siinstagram_business_manage_comments.- 1:API setup with Instagram login
- 2:Instagram app ID
- 3:App secret (Show)
- 4:Permissions
Add yourself as a tester
Accept the invitation in Instagram: Settings → Website permissions → Apps and websites → Tester Invites → Accept. On the web it's at instagram.com/accounts/manage_access.
- 1:Tester Invites
- 2:Your app
Set the redirect URI
Copy the redirect URI from Publit.Si, Settings › Platform setup › Instagram.
Enter the keys
Copy the Instagram app ID and the Instagram app secret (behind Show) from API setup with Instagram login. Not the Facebook app ID at the top of the page.
Enter them in Publit.Si under Settings › Platform setup › Enter credentials, or in
.env. Leave theINSTAGRAM_UNIFIED_*settings empty – once one is set, Publit.Si uses Unified login.INSTAGRAM_APP_ID=… INSTAGRAM_APP_SECRET=… INSTAGRAM_INSIGHTS=1 # if you added the insights permission INSTAGRAM_COMMENTS=1 # if you added the comments permission
Check
Settings › Platform setup › Instagram shows every item as set – the guide there follows your .env (Unified login or the older way). When you publish your first post, the connection shows your account.
Troubleshooting
redirect_uri_mismatch- The redirect URI in the dashboard must match exactly, including
http/httpsand port. - Instagram: "Insufficient developer role"
- The account hasn't accepted the tester invitation, or Chrome is signed in to another account.
- Instagram: "Invalid scope"
- Old way (4b): a permission from step 4b.3 is missing. Switch off Instagram: views and reach under Settings › Platforms › Statistics and comments (or set
INSTAGRAM_INSIGHTS=0and restart), then reconnect. - Meta: "API setup with Instagram login is not available for newer apps"
- Your app is new. Set it up with Unified login (step 4a).
- Instagram: "Invalid platform app" or "Invalid Scopes"
- The login still went the old way with a new app. Set
INSTAGRAM_UNIFIED_APP_ID,INSTAGRAM_UNIFIED_APP_SECRETandINSTAGRAM_UNIFIED_CONFIG_ID(step 4a.6), restart and connect again. - Instagram: "Meta did not say which Instagram account you shared"
- Set
INSTAGRAM_UNIFIED_ACCOUNT_IDto the account's ID (step 4a.7), restart and connect again. Or add the optional permissionbusiness_management(step 4a.4), then Publit.Si can usually find the account itself. - Instagram: "… is not reachable with this login"
- The ID in
INSTAGRAM_UNIFIED_ACCOUNT_IDis wrong, or you didn't choose that account in Meta's dialog. Check the ID in Meta Business Suite → Settings → Instagram accounts. - Instagram: "publishing permission is missing"
- Unified login (4a):
instagram_content_publishisn't in your login configuration, or it was unticked in Meta's dialog. Not offered in the configuration? Add it under Use cases → Manage messaging & content on Instagram → Customize → Permissions and features first (step 4a.4). Then connect again and allow all. - Meta's configuration template wants to create an ad account
- Remove ad accounts and the ads permissions from the configuration (step 4a.4). Publit.Si needs none.
- Instagram can't load media
- Bot Fight Mode is still on for the tunnel host.
Stuck? Search the troubleshooting list or write to us . Leave out secrets and tokens.






