Log inStart Free Trial
easyCoexistence Official APIs

Instagram API errors: what the common codes mean

The most common Instagram API errors are 190 for an expired or invalid token, 4, 17 and 80002 for rate limits, 9004 for media Meta cannot fetch, 9007 for a video still processing, 9 for the daily publishing cap, and 10 with subcode 2534022 for a DM outside the messaging window. Each arrives as JSON with a code, often a subcode that names the exact case, and a message.

easyCoexistence takes care of the connection side of these errors: it renews Instagram access before it expires, checks the account every 6 hours and emails you when it needs reconnecting.

190

Graph API code for an access token that has expired, been revoked or is otherwise invalid.

80002

Error code for Instagram's Business Use Case rate limit.

2207042

Subcode, under code 9, for an account that has reached its daily API publishing limit.

2207052

Subcode, under code 9004, for media Meta could not fetch from the URL given.

2534041

Subcode, under code 200, when the account has turned off access to its Instagram messages.

How do you read an Instagram API error?

Every error is a JSON object under error. code is the broad category, error_subcode names the specific case and is usually the more useful of the two, and message describes it. Many errors also carry error_user_title and error_user_msg, text meant for the person, and is_transient. fbtrace_id identifies the request for Meta support and expires shortly, so log it when the error happens.

What do access and permission errors mean?

Errors about who may do what, with the fix for each:

  • 190: the access token has expired, been revoked or is otherwise invalid; subcode 463 means expired, 467 invalid and 460 a changed password. A new token fixes it, which for a connected account means reconnecting.
  • 10: permission denied. A permission was never granted or has since been removed.
  • 200 to 299: a specific permission is missing, for example 200 with subcode 2534041 when the account has turned off access to its messages.
  • 25, subcode 2207050: the account is restricted, inactive or checkpointed; the owner has to sign in to the Instagram app and complete what it asks.

What do rate limit errors mean?

Throttling, and all of it temporary:

  • 4: too many calls from the app; wait and retry, or lower the request volume.
  • 17: too many calls for the user; the same remedy applies.
  • 80002: Instagram's Business Use Case limit, worked out per app and account from the account's impressions: 4,800 calls per impression over 24 hours.
  • 613, subcode 2534040: too many messaging calls; pause and try again later.

What do publishing errors about the media mean?

Errors about the file and where it is hosted; only the timeout is worth retrying as it stands:

  • 9004, subcode 2207052: Meta could not fetch the media from the URL; make sure it is valid and public.
  • -2, subcode 2207003: the download took too long; this one is worth trying again.
  • 36000, subcode 2207004: the image is over 8 MB.
  • 36001, subcode 2207005: the image format is not supported; use JPEG.
  • 36003, subcode 2207009: the aspect ratio falls outside 4:5 to 1.91:1.
  • 352, subcode 2207026: the video format is not supported; use MOV or MP4.

What do publishing errors about timing and limits mean?

Errors about when and how much, most of them solved by waiting or starting over:

  • 9007, subcode 2207027: the media is not ready; wait until the container's status_code reads FINISHED.
  • 24, subcode 2207008: the container does not exist or has expired; retry once or twice within 30 seconds to 2 minutes, then create a new one.
  • -2, subcode 2207020: the media has expired; create a new container.
  • 9, subcode 2207042: the account reached its daily publishing limit; try again the next day.
  • 100, subcode 2207028: a carousel needs 2 to 10 items.
  • 36004, subcode 2207010: the caption is too long; Meta's limits are 2,200 characters and 20 @ tags, and its reference lists 30 hashtags, though Instagram allows 5 on a post.
  • 4, subcode 2207051: Instagram restricted the action as suspected spam.

What do messaging errors mean?

Errors from DMs and private replies:

  • 10, subcode 2534022: the message was sent outside the allowed window; wait for the person to write again.
  • 100, subcode 2534014: no matching Instagram user; use the Instagram-scoped ID from the webhook, not an Instagram user ID.
  • 100, subcode 2534025: the comment cannot take a private reply.
  • 100, subcode 2534037: another app, Meta's own Business AI included, controls the conversation.
  • 551, subcode 1545041: the person isn't available right now.

What do insights errors mean?

Insights requests fail in three documented ways:

  • 10, not enough viewers for the media to show insights: a Story metric under 5.
  • A retired metric, such as impressions since 21 April 2025, returns an error; ask for views instead.
  • An unknown error when one of several requested metrics does not support the breakdown asked for.

Which errors are worth retrying?

Only the temporary ones: codes 1 and 2, the Instagram server errors 2207001 and 2207032, the download timeout 2207003, the brief 2207008, and rate limits once the wait is over. Everything else returns the same answer until something changes, whether the file, the URL, a permission, the account's state or the person's window, and retrying those only spends the rate limit.

Common mistakes

  • Retrying a format or size error. 2207004, 2207005, 2207009 and 2207026 fail the same way until the media changes.
  • Treating 9007 as a failure. The video is still processing; publish when the container reads FINISHED.
  • Reading only the code. Codes such as 10 and 100 cover many cases, and the subcode is what names this one.
  • Dropping fbtrace_id from logs. Meta support asks for it, and it expires shortly after the error.
Doing this with EasyCoexistence

Claude, ChatGPT or your own code then call Meta's official API with a token that is kept current. 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

What does error 190 mean on Instagram?

The access token has expired, been revoked or is otherwise invalid, for example after a password change. A new token fixes it, and for a connected account that means reconnecting.

Why does publishing fail with 9004?

Meta could not fetch the media from the URL given, subcode 2207052. Check that the link is valid and public, with no login in front of it, at the moment the post is published.

What is error 9007?

The video in the container is still processing, subcode 2207027. Check the container's status_code and publish once it reads FINISHED.

What is fbtrace_id in an Instagram API error?

An identifier for the failed request, which Meta support asks for when you report a problem. It expires shortly after the error, so write it to your logs at the time.

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