Log inStart Free Trial
easyCoexistence Official APIs

Instagram API guide for 2026: from your app to your first post

In 2026 the Instagram API takes an app to its first post in six steps: a professional account, a login setup, a Meta app, permissions at the right access level, an access token, then a media container created with POST /<IG_ID>/media and published with media_publish. Comments, DMs, webhooks, insights and Meta's limits come after. For new apps, Meta recommends Unified Login.

easyCoexistence turns steps 2 to 5 into one sign-in with Instagram: its Meta app runs the login, renews the token before it expires and checks the account every 6 hours, while Claude, ChatGPT or your own platform publishes, schedules, replies to comments and DMs and reads insights through Meta's official API.

3 setups

Unified Login, recommended for new integrations, plus Instagram Login and Facebook Login, kept for existing ones.

New apps

Newly created Meta apps can't set up the Instagram API with Instagram Login, Meta's migration guide says.

60 days

How long a long-lived Instagram User access token lasts; a refresh is possible once it is 24 hours old.

100 posts

API-published posts one account can make in a 24-hour moving period, a carousel counting as one.

2 to 3 days

What App Review often takes, by Meta's account; it typically processes a submission in under a week.

What are the steps from a new app to a first post?

Six steps lead to the first post, and four more shape what the app does after it. The account has to be professional, the app picks one of Meta's three login setups, the account owner grants permissions, and the app's server holds a token. Publishing is then two calls. Comments, DMs, webhooks, insights and limits follow, and the last sections name the page that covers each step in full.

1Professional accountBusiness or Creator, switched in the Instagram app
2Login setupUnified Login for new apps, Instagram Login for existing ones
3Meta app and permissionsStandard Access to test, Advanced Access through App Review
4Access tokenFrom the owner's sign-in, kept on the server
5First postPOST /<IG_ID>/media, then media_publish

Step 1: which Instagram account works with the API?

A professional account, business or creator. Meta's Instagram Platform serves professional accounts only, and both types work the same way for publishing, comments, DMs and insights. A personal account switches in the Instagram app, under Account type and tools, and a private one becomes public when it does. Instagram Login and Unified Login need no linked Page, while Facebook Login requires one.

Step 2: which login setup should the app use?

Meta documents three, and the choice fixes the host, the token and the permission names. Its overview recommends Unified Login for new integrations, its Unified Login page says new Instagram API features are released only there, and its migration guide says newly created apps can't set up Instagram Login. Existing Instagram Login integrations keep working, with no end date announced.

  • Unified Login: the client signs in with Instagram or through Facebook Login, picks a business portfolio, and the app receives a Business Integration System User token.
  • Instagram Login: the owner signs in with Instagram, and calls go to graph.instagram.com with an Instagram User token and the instagram_business_* permissions.
  • Facebook Login: the account must be linked to a Page the person can manage, with the instagram_* and Page permissions.

Step 3: how is the Meta app created?

In the App Dashboard, along a path that depends on the setup. Meta's Unified Login guide starts from an app with the Manage messaging & content on Instagram use case, owned by a business portfolio. Under API setup with Unified login, the app creates a configuration, whose config_id names the permissions and assets to request, saves an HTTPS redirect URL and copies the login URL. An existing Instagram Login app keeps API setup with Instagram login, where its Instagram app ID and secret live.

Step 4: which permissions and access level does the app need?

One permission per feature, granted by the account owner at sign-in. Unified Login uses the instagram_* family, such as instagram_content_publish and instagram_manage_comments, and Instagram Login the instagram_business_* names. Standard Access, the default, covers accounts you own or manage and people with a role on the app. Serving other businesses' accounts takes Advanced Access, granted permission by permission through App Review, with Business Verification.

Step 5: how does the app get an access token?

From the owner's sign-in, exchanged on the server and never in a browser or mobile app. With Instagram Login, the redirect carries a code valid for one hour and usable once; it becomes a short-lived token, then a long-lived one that lasts 60 days and can be refreshed once it is a day old. With Unified Login, the code becomes a Business Integration System User token, whose expiry depends on the configuration.

Step 6: how do you publish a first post?

With two calls. POST /<IG_ID>/media with a public image_url, which Meta fetches itself, creates a container; POST /<IG_ID>/media_publish with that container's ID as creation_id publishes it and returns the media ID. Images must be JPEG. For a Reel or another video, check the container's status_code until it reads FINISHED, since publishing earlier fails.

A first photo post with Instagram Login
POST https://graph.instagram.com/v26.0/<IG_ID>/media
  ?image_url=https://www.example.com/images/first-post.jpg
  &caption=Hello%20from%20the%20API
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_CONTAINER_ID>" }

POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
  ?creation_id=<IG_CONTAINER_ID>
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_MEDIA_ID>" }

Step 7: how do comments and DMs work?

Both start with someone else. GET /<IG_MEDIA_ID>/comments returns up to 50 top-level comments per request, POST /<IG_COMMENT_ID>/replies answers one in public, and a private reply sends the commenter a single DM within 7 days of the comment. DMs go to people who wrote first, within a standard window of 24 hours for most actions, once the owner turns on Allow access to messages in the Instagram app.

Step 8: how do webhooks tell the app what happened?

Meta POSTs JSON to an HTTPS endpoint, which proves itself once by echoing hub.challenge, and signs each event in X-Hub-Signature-256 with an HMAC-SHA256 of the payload, keyed with the app secret. The app selects fields such as comments and messages in the App Dashboard, then subscribes each account through its subscribed_apps edge. Notifications reach Live apps only, and comment notifications need Advanced Access.

Step 9: how does the app read insights?

From two edges: GET /<IG_ID>/insights for the account and GET /<IG_MEDIA_ID>/insights for a post, Reel or Story. Account metrics such as reach, views and accounts_engaged take period=day with metric_type=total_value. views replaced impressions in 2025, some metrics need at least 100 followers, and Meta notes the data can lag by up to 48 hours.

Step 10: which limits shape the app?

Meta sets its main limits per account, so a new account brings its own allowance instead of sharing one:

  • Calls: 4,800 times the account's impressions in a rolling 24 hours, per app and account, messaging excluded.
  • Publishing: 100 API-published posts and 400 media containers per account in 24 hours.
  • Messaging: 100 Send API calls a second for text, and 750 private replies an hour on posts and Reels.
  • Containers: one left unpublished for 24 hours expires and has to be created again.

Which page covers each step in detail?

Each step has a reference page of its own in these docs, with the fields, errors and edge cases this guide leaves out. The paths below sit under the site's address, and the code page shows the publishing, comment, insight and webhook calls in Python and Node.js, side by side:

Account type/docs/instagram/business-or-creator-account
Login setups/docs/instagram/unified-login
Meta app and access/docs/instagram/api-access, /docs/instagram/app-review
Permissions/docs/instagram/api-permissions
Tokens/docs/instagram/access-tokens
Code/docs/instagram/api-python-node
Publishing/docs/instagram/publishing-limits
Webhooks/docs/instagram/webhook-events
Insights/docs/instagram/insights-metrics
Limits/docs/instagram/api-rate-limits
When it stops working/docs/instagram/connection-lost

What is the path through easyCoexistence?

A single sign-in in place of steps 2 to 5 and the webhook setup. In the dashboard, choose New connection, then Instagram, log in with the Business or Creator account and approve its five instagram_business_* permissions; easyCoexistence's Meta app runs the login, renews the token and checks the account every 6 hours. Claude, ChatGPT or your own agent then works through https://easycoexistence.com/api/mcp, your own code can take the account's ID and API base from get_social_credentials, and posts can be scheduled up to 90 days ahead from easyCoexistence's queue.

Common mistakes

  • Starting a new app on Instagram Login. Meta's migration guide says newly created apps can't set it up, and its overview recommends Unified Login for new integrations.
  • Calling a Unified Login integration with an Instagram User token. Meta's webhook guide says those tokens and graph.instagram.com don't work with Unified Login.
  • Publishing a video container straight away. media_publish fails with subcode 2207027 until the container's status_code reads FINISHED.
  • Polling for comments and DMs. Meta recommends webhooks, which cut the calls an app makes and its risk of being rate limited.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

How long does it take to get Instagram API access?

For accounts you own or manage, no wait: Standard Access works from the start. Serving other businesses takes App Review, which Meta says typically takes under a week, and Business Verification.

Can a new Meta app still use Instagram Login?

Not according to Meta's migration guide, which says newly created apps can't set it up. Existing Instagram Login integrations keep working, and Meta has announced no end date.

Can the API publish a file from my computer?

Not with Instagram Login, where Meta fetches each image or video from a public URL. Meta documents resumable uploads, which accept a local video file, for setups built on Facebook Login for Business, Unified Login included.

How much does easyCoexistence cost for an Instagram account?

Each Instagram account is one connection: US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on