Instagram Messaging API · error code

Instagram error 25: The Instagram account is restricted (2207050)

ConfigurationHTTP 400Content publishing (posts, reels, stories)

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
The Instagram account is restricted.

What error 25 means

Code 25 with subcode 2207050 means the Instagram professional account you are publishing for is not in good standing. Meta's explanation lists three states: the account is inactive, checkpointed, or restricted. A checkpoint is Instagram asking the owner to confirm something - a login challenge, identity check, or acknowledgment - before the account can be used normally again.

Your app cannot clear any of these states through the API. The recommended solution is to advise the app user to sign in to the Instagram app and complete whatever actions it requires to re-enable the account. Until they do, every publish attempt for that account fails the same way, while other accounts on the same app keep working.

That per-account pattern is the quickest way to tell this apart from a token or permission problem. If one customer's posts fail with 2207050 and everyone else's succeed, the integration is fine.

What it looks like

{
  "error": {
    "type": "OAuthException",
    "code": 25,
    "error_subcode": 2207050,
    "error_user_msg": "The Instagram account is restricted.",
    "fbtrace_id": "F8sLc5VbNuKy1Wp"
  }
}

Why it happens

  • Instagram placed the account in a checkpoint that the owner has not completed.
  • The account was restricted for a policy or community guidelines issue.
  • The account is inactive or temporarily disabled.
  • A suspicious-login check was triggered, for example after access from a new location or device.

How to fix Instagram error 25

  1. 1Stop publishing to the account and surface a clear notice to its owner in your app.
  2. 2Ask the owner to sign in to the Instagram app and complete any prompts, checks or appeals it shows.
  3. 3Once they confirm the account is usable, publish one test post before releasing queued content.
  4. 4If the account was disabled, the owner must follow Instagram's in-app appeal flow; there is no API path.

How to stop it recurring

Track account health per connected account, not globally, and suspend that account's queue on the first 2207050 instead of retrying every scheduled post. Let owners resume publishing themselves after they clear the checkpoint. Spam-flagged publishing activity is a separate case covered by 4/2207051; messaging-side restrictions appear as 100/2534029.

Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.

Related codes

Error 25 - quick answers

What does Instagram error 25 mean?

Code 25 with subcode 2207050 means the Instagram professional account you are publishing for is not in good standing. Meta's explanation lists three states: the account is inactive, checkpointed, or restricted. A checkpoint is Instagram asking the owner to confirm something - a login challenge, identity check, or acknowledgment - before the account can be used normally again.

How do I fix Instagram error 25?

1. Stop publishing to the account and surface a clear notice to its owner in your app. 2. Ask the owner to sign in to the Instagram app and complete any prompts, checks or appeals it shows. 3. Once they confirm the account is usable, publish one test post before releasing queued content. 4. If the account was disabled, the owner must follow Instagram's in-app appeal flow; there is no API path.

Stop debugging Instagram by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.