Log inStart Free Trial
easyCoexistence Official APIs

Why an Instagram API connection stops working, and how to keep it alive

An Instagram API connection stops working when Meta no longer accepts its token or the account no longer qualifies: a long-lived token left unrefreshed for 60 days, a password change, a permission or the whole app removed by the owner, a switch to a personal account, or a restriction on the account. Each returns its own error, and most are fixed by the owner signing in again.

easyCoexistence watches each Instagram connection around the clock: it refreshes the token well before the 60 days run out, checks the account every 6 hours, emails you once when Meta refuses access and sends platforms channel.disconnected, so a dropped connection is back with one sign-in.

60 days

Instagram tokens not refreshed within 60 days expire and can no longer be refreshed.

460

Graph API subcode, under code 190, for a session ended by a password change; the person logs in again.

1 hour

Of failed messaging webhook deliveries before Meta disables them and unsubscribes the app from the account.

28 days

Meta may end an app's access to permissions or features it has not used within a 28-day period.

6 hours

How often easyCoexistence checks each connected Instagram account, renewing its token well before the 60 days run out.

Why does an Instagram API connection stop working?

Because Meta stops accepting the token, or the account stops qualifying for the API. Meta's documentation names the causes, each with what the API returns and the step that restores access. Most of them show up first as a failed call, which is why the checks further down look for them on a schedule:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA new sign-in, if the owner wants it back
Switched to a personal account(#10) Access is denied because the instagram account type is not business or creator.Back to Business or Creator, then a new sign-in
Allow access to messages offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

When does a token expire, and when can it still be refreshed?

With Instagram Login, a long-lived token lasts 60 days from its last refresh. A refresh with grant_type=ig_refresh_token gives it another 60 days, provided it is at least 24 hours old, has not expired, and the owner granted instagram_business_basic. Once the 60 days pass, calls fail with code 190 and only a new sign-in helps. With Unified Login, the configuration sets whether the token expires at all.

What do a password change and a removed permission do?

A password change can end the session the token belongs to: Meta's Graph API error guide reports it as code 190 with subcode 460 and says the person must log in to the app again. A permission that was never granted or has been removed returns code 10, or a code from 200 to 299; on DMs, code 200 with subcode 2534041 means the owner turned off access to messages. Meta's Platform Terms also let it end an app's access to a permission or feature unused for 28 days.

What happens when the owner removes the app?

Its access to non-public data ends. The owner removes the app in Instagram under Website permissions, Apps and websites, Active, and Meta calls the deauthorize callback URL saved in the app's business login settings. Instagram's Help Center says a removed app can reach only the account's public information from then on, so the connection is over until the owner signs in again.

What happens when the account changes type or is restricted?

Either one takes the account outside what the API serves. Meta's API works with professional accounts only, and its Unified Login troubleshooting table gives the message (#10) Access is denied because the instagram account type is not business or creator for an account switched to personal; the owner switches back, then connects again. A restricted, inactive or checkpointed account returns code 25 with subcode 2207050, which the owner resolves in the Instagram app.

How do webhooks stop arriving?

Through a failing endpoint. Meta retries an Instagram notification for up to 36 hours, but messaging deliveries are stricter: after 15 minutes of failures, an alert goes to the developer account, and after an hour Meta sends a Webhooks Disabled alert and unsubscribes the app from the account. Once the endpoint works again, POST /<IG_ID>/subscribed_apps with the same fields turns notifications back on.

How do you notice a drop before users do?

By checking the connection on a schedule instead of waiting for a post to fail:

  • Store expires_in from each token exchange and refresh well before day 60, once the token is a day old.
  • Make a cheap authenticated call on a schedule, such as GET /me?fields=user_id,username, and treat code 190 or 102 as a reconnect.
  • Serve the deauthorize callback, so a removal in Instagram's settings reaches you at once.
  • Read Developer Alerts and the business email on the app, where Meta sends webhook and review notices.
  • Log the code, subcode and fbtrace_id of each error per account, so a restriction stands apart from a bad request.

How do you reconnect each case?

Most causes end in the same step, a new sign-in by the account owner, which issues a fresh code and token. The exceptions are settings the owner changes in the Instagram app:

  • Expired token, password change, removed app or permission: send the owner through the login again and let them approve the permissions.
  • Personal account: switch back to Business or Creator in the Instagram app, then sign in again.
  • Messages turned off: turn on Allow access to messages under Connected tools; no new sign-in is needed.
  • Restricted account: complete what the Instagram app asks; a new sign-in changes nothing.
  • Disabled webhooks: fix the endpoint, then subscribe the account again.

What does easyCoexistence do to keep a connection alive?

It watches each connected Instagram account around the clock. It refreshes the token once fewer than 20 of its 60 days remain, checks the account every 6 hours with GET /me, and marks the connection for reconnecting the moment Meta refuses the token, whether in that check or in a tool call. It answers Meta's webhook deliveries at once and forwards them afterwards, and when the owner removes the app in Instagram's settings, Meta's deauthorize callback ends the connection and takes it off the bill.

How does easyCoexistence tell you, and how do you reconnect?

Once, by email, naming the account, with a button to the channel's page; platforms also receive a signed channel.disconnected event. Until the owner acts, list_social_accounts shows the status and Meta's last error, and the tools reply that the account needs to be reconnected. Reconnecting is one sign-in with the same Instagram account, which revives the same connection with its settings.

Common mistakes

  • Refreshing a token only after a call fails. Once it has expired, Meta refuses the refresh, so schedule renewals while it is still valid.
  • Sending a restricted account back through the login. Code 25 with subcode 2207050 is the account's state, which the owner fixes in the Instagram app.
  • Leaving the deauthorize callback unset. A removal in Instagram's settings then surfaces only when the next call fails.
  • Fixing a failed endpoint and waiting. After a Webhooks Disabled alert, notifications stay off until the account is subscribed again with POST /<IG_ID>/subscribed_apps.
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

Does using an Instagram token keep it from expiring?

No. Only a refresh extends a long-lived token, and one that goes 60 days without a refresh expires however often it was used.

Does Instagram remove a business app after 90 days without use?

No. Instagram's Help Center says apps with permissions for managing business and creator accounts are not expired after 90 days of inactivity.

Does a disconnected account still count on the easyCoexistence bill?

Yes, until you reconnect or remove it. An account whose owner removed the app in Instagram's settings leaves the count as soon as Meta reports the removal.

How much does easyCoexistence cost to monitor an Instagram account?

Monitoring comes with each 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