Instagram

Instagram is PlugKit’s most complete integration: publishing, messaging, comments and analytics, all through Meta’s official Instagram API with Instagram Login. Requires an Instagram professional (business or creator) account.

Publish

Images with captions.

Messaging

Read & reply to DMs.

Comments

List & reply on posts.

Analytics

Followers, reach, impressions.

Connect

Standard OAuth 2 flow — request a URL, the user approves, PlugKit stores a long-lived token.

Get the authorization URL

curl "https://api.plugkit.co/v1/connect/instagram?profileId=YOUR_PROFILE_ID" \
  -H "Authorization: Bearer sk_your_key"

→ { "authUrl": "https://www.instagram.com/oauth/authorize?..." }

Send the user to authUrl

They log into their Instagram business account and approve the scopes.

PlugKit stores the account

Instagram redirects to /connect/instagram/callback; PlugKit exchanges the code for a long-lived token, subscribes the account to webhooks, and exposes it in GET /accounts.

Publish

Instagram publishing is a two-step process (create a media container, then publish) — PlugKit runs both for you. Provide a public image URL:

curl -X POST https://api.plugkit.co/v1/posts \
  -H "Authorization: Bearer sk_your_key" -H "Content-Type: application/json" \
  -d '{ "profileId": "PROFILE_ID", "accountIds": ["ACCOUNT_ID"],
        "content": "Launch day 🚀", "mediaUrls": ["https://…/photo.jpg"], "publishNow": true }'

No public URL? Upload the file first.

Messaging

Read and reply to DMs. Inbound messages arrive via webhooks, or pull them on demand with sync:

Sync + list

curl -X POST "https://api.plugkit.co/v1/conversations/sync?accountId=ACCOUNT_ID" -H "Authorization: Bearer sk_your_key"
curl "https://api.plugkit.co/v1/conversations?accountId=ACCOUNT_ID" -H "Authorization: Bearer sk_your_key"

Reply / send a direct DM

curl -X POST https://api.plugkit.co/v1/conversations/CONVERSATION_ID/messages \
  -H "Authorization: Bearer sk_your_key" -H "Content-Type: application/json" -d '{ "text": "Hi! 👋" }'

Meta’s rule: you can only message a user who contacted you within the last 24h, unless you use an approved template.

Comments

curl https://api.plugkit.co/v1/accounts/ACCOUNT_ID/media -H "Authorization: Bearer sk_your_key"          # recent posts
curl https://api.plugkit.co/v1/accounts/ACCOUNT_ID/media/MEDIA_ID/comments -H "Authorization: Bearer sk_your_key"
curl -X POST https://api.plugkit.co/v1/accounts/ACCOUNT_ID/comments/COMMENT_ID/reply \
  -H "Authorization: Bearer sk_your_key" -H "Content-Type: application/json" -d '{ "message": "Thanks! 🙏" }'

Analytics

curl https://api.plugkit.co/v1/accounts/ACCOUNT_ID/insights -H "Authorization: Bearer sk_your_key"

Returns followers, media count, reach, impressions and profile views. Details in the Analytics guide.

Permissions

Instagram grants these scopes on connect: instagram_business_basic, …_content_publish, …_manage_messages, …_manage_comments, …_manage_insights. Each capability above needs its matching scope.

Get started

Core concepts

Platforms

Guides

Publish

Messaging

Comments

Analytics

Connect

Publish

Messaging

Comments

Analytics

Permissions

Publish

Messaging

Comments

Analytics

​Connect

​Publish

​Messaging

​Comments

​Analytics

​Permissions

Connect

Publish

Messaging

Comments

Analytics

Permissions