SocialMati
SocialOAuth 2.0 through the Meta app (Facebook Login)Pricing verified 2026-10-06

Instagram

Publish photos, carousels and reels, reply to comments and DMs, and read insights for Instagram professional accounts.

AProvider definition

Provider
Instagram
What it does
Publish photos, carousels and reels, reply to comments and DMs, and read insights for Instagram professional accounts.
Why we need it
Publish photos, carousels and reels, reply to comments and DMs, and read insights for Instagram professional accounts.
Used in
Social (publish, comments, inbox) · Analytics

BAccount requirements

Account type
Instagram Business or Creator account linked to a Facebook Page
Prerequisites
  • The Meta app described under Facebook / Meta
  • Admin role on the linked Page
Verification
Business Verification and App Review for instagram_content_publish, instagram_manage_comments and instagram_manage_messages.

CConnection method

Authentication
OAuth 2.0 through the Meta app (Facebook Login)
Credentials
Uses the Facebook / Meta credentials — no separate key.
Where to enter it
  • Your workspace: App → Integrations → Providers & API keysWorkspace owner or admin. Keys added here are used only by your workspace (AI keys here don't use plan credits).
  • Per brand: App → Integrations → Connected accountsAnyone who manages the brand. Each brand connects its own accounts.

Setup steps

  1. 1Convert the Instagram account to Professional (Settings → Account type and tools).
  2. 2Link it to a Facebook Page (Instagram → Edit profile → Page, or Page settings → Linked accounts).
  3. 3Set up the Meta app (see Facebook / Meta) — Instagram uses the same App ID and secret.
  4. 4Integrations → Connected accounts → Connect Instagram, and approve the Page linked to the account.

DPermissions & API scopes

Scope / permissionWhy it's neededRequested by
pages_show_listList the Pages you manage so you can pick which to connect.Facebook & Instagram connection
pages_read_engagementRead Page posts, followers and engagement for analytics.Facebook & Instagram connection
pages_manage_postsPublish, schedule and delete posts on your Pages.Facebook & Instagram connection
pages_manage_engagementReply to and moderate comments.Facebook & Instagram connection
pages_read_user_contentRead comments and posts by others on your Pages.Facebook & Instagram connection
pages_manage_metadataSubscribe your Page to webhooks for real-time comments and messages.Facebook & Instagram connection
pages_messagingRead and reply to Messenger conversations in the inbox.Facebook & Instagram connection
read_insightsRead Page insights for analytics and reports.Facebook & Instagram connection
business_managementAccess Pages and assets owned by your Business Portfolio.Facebook & Instagram connection
leads_retrievalImport Facebook/Instagram Lead Ads submissions into the CRM.Facebook & Instagram connection
pages_manage_adsManage Lead Ads forms connected to the Page.Facebook & Instagram connection
instagram_basicRead the connected Instagram professional account profile and media.Facebook & Instagram connection
instagram_content_publishPublish photos, carousels and reels to Instagram.Facebook & Instagram connection
instagram_manage_commentsRead and reply to Instagram comments.Facebook & Instagram connection
instagram_manage_messagesRead and reply to Instagram DMs in the inbox.Facebook & Instagram connection
instagram_manage_insightsRead Instagram post and account insights.Facebook & Instagram connection
ads_management(Meta Ads) Create, pause and change budgets of campaigns.Meta Ads connection
ads_read(Meta Ads) Read campaign spend and results.Meta Ads connection
business_managementAccess Pages and assets owned by your Business Portfolio.Meta Ads connection
pages_show_listList the Pages you manage so you can pick which to connect.Meta Ads connection
pages_read_engagementRead Page posts, followers and engagement for analytics.Meta Ads connection
leads_retrievalImport Facebook/Instagram Lead Ads submissions into the CRM.Meta Ads connection
pages_manage_adsManage Lead Ads forms connected to the Page.Meta Ads connection

This list is generated from the scopes the application's code requests.

EFree vs paid

Free account / free API access
Yes — no fee for API access.
Card or billing account required?
No.
Paid plan / costs
None for API access.
Quota and usage limits
A limited number of API-published posts per account per 24 hours; per-app rate limits.
Production restrictions
Advanced Access via App Review is needed for accounts you don't own; reviews commonly take 2–4 weeks and first submissions are often rejected.
Checked against official/current sources on 2026-10-06. Provider pricing changes often — re-check before publishing.

FSetup screenshots

Capture each step with real values masked. Save images as public/docs/integrations/instagram/1.png … 10.png and they appear here automatically.

  1. Screenshot to add
    1. Account login / creation
    The provider's sign-in or sign-up page.
  2. Screenshot to add
    2. Developer console
    The developer console or dashboard home.
  3. Screenshot to add
    3. Project / app creation
    Creating the app or project used for this integration.
  4. Screenshot to add
    4. API enablement
    The API or product enabled for the project.
  5. Screenshot to add
    5. OAuth configuration
    Consent screen / OAuth settings with the redirect URIs.
  6. Screenshot to add
    6. API key / credentials creation
    Creating the key, secret or token (mask the value).
  7. Screenshot to add
    7. Permissions / scopes
    The scopes or permissions requested or approved.
  8. Screenshot to add
    8. Billing / quota settings
    Billing, credits or quota page.
  9. Screenshot to add
    9. Application connection
    The provider card in our application with fields filled (secrets masked).
  10. Screenshot to add
    10. Successful connection
    The green Test result or the connected account listed.

GApplication configuration

Never include real API keys, client secrets, access tokens or passwords in screenshots, tickets or documentation. Values below are field names and examples only.

Nothing to enter for this product — it uses the Facebook / Meta credentials. Connect it from the location in section C.

HTesting

  1. 1Connect the account, then Social → Create post → publish one image to Instagram.
  2. 2Comment on it from another account and check Social → Comments.

ITroubleshooting

ProblemWhat to do
Account not foundPersonal accounts can't use the API. Switch to Business/Creator and link a Page.
Publishing fails for reelsVideo must meet Instagram's format limits (MP4/H.264, aspect ratio, duration).
Invalid credentialsCheck the Client ID/App ID and secret were copied from the same app, without spaces. Regenerate the secret if unsure.
Missing permissionsReconnect and accept every permission on the consent screen. If a permission is missing from the list, add it to the app (and get it approved).
OAuth failureSign-in was cancelled, the app is in development/testing mode, or the user isn't allowed to use it yet. Add the user as a tester or publish the app.
Redirect URI mismatchCopy the redirect URI from section G exactly — same https scheme, host and path, no trailing slash — into the provider's app settings.
API not enabledEnable the API/product for the project or app in the provider console and wait a few minutes.
Quota exceededWait for the quota window to reset (see section E) or request a higher quota / add credits.
Account not eligibleCheck the account requirements in section B (e.g. business/professional account, verified property, registered organisation).
App review requiredPermissions beyond development access need the provider's review before other accounts can connect. See section E for restrictions.
Billing requiredAdd a payment method or prepaid credits on the provider account (see section E).

JDisconnect & security

Revoke access at the provider
Instagram → Settings → Apps and websites → remove the app; or disconnect in the application.
Disconnect in the application
App → Integrations → Providers & API keys or App → Integrations → Connected accounts → open the card → Remove / Disconnect. Connected accounts can be disconnected per brand.
Rotate credentials
Create the new key or secret first, paste it into the same card and Test, then delete the old one at the provider — no downtime.
How credentials are stored
Encrypted at rest with AES-256-GCM using the server's ENCRYPTION_KEY, shown masked after saving, never returned to the browser, and used only from the API server.
What data the application can access
The professional account's media, comments, messages and insights.

Other Social providers

Start Free