Instagram Messaging API · error code

Instagram error 100: Too many @ tags on the media (2207040)

Permanent - do not retryHTTP 400Content publishing (posts, reels, stories)

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
Cannot use more than {max-tag-count} tags per created media.

What error 100 means

Code 100 with subcode 2207040 is the tag-count ceiling. Meta's recommended solution says the app user exceeded the maximum number of @ tags - 20 - and should use fewer. The message substitutes the current maximum for {max-tag-count}.

The limit concerns people tagged on the media. On the container request those arrive through user_tags, an array of objects each holding a public username and, for images, x and y coordinates between 0.0 and 1.0. The caption has its own matching cap of 20 @ mentions, so an app that both tags people on the image and mentions them in text should keep both counts in mind.

Nothing else about the post is wrong. The fix is a smaller tag list, and because the container was rejected, a new container request with the trimmed list. Bulk tools that auto-tag every collaborator, team member or customer in a photo are the usual way to exceed the limit.

What it looks like

{
  "error": {
    "type": "OAuthException",
    "code": 100,
    "error_subcode": 2207040,
    "error_user_msg": "Cannot use more than 20 tags per created media.",
    "fbtrace_id": "PqT6fMs1XkAv3Bg"
  }
}

Why it happens

  • The user_tags array holds more than 20 entries.
  • An automation tags every participant from a CRM or event list without capping the count.
  • Duplicate usernames in user_tags inflate the total.
  • The caption also carries more than 20 @ mentions.

How to fix Instagram error 100

  1. 1Count the entries in user_tags and reduce them to 20 or fewer.
  2. 2Deduplicate usernames before building the array.
  3. 3Check the caption separately and keep @ mentions to 20 or fewer.
  4. 4Create a new container with the trimmed tag list.

How to stop it recurring

Cap tags in the composer UI, deduplicate on username, and re-check the count server-side right before the container request. If your product tags many people by design, let users choose which 20 matter rather than truncating silently. Caption-length and hashtag rules are covered by 36004/2207010.

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

Related codes

Error 100 - quick answers

What does Instagram error 100 mean?

Code 100 with subcode 2207040 is the tag-count ceiling. Meta's recommended solution says the app user exceeded the maximum number of @ tags - 20 - and should use fewer. The message substitutes the current maximum for {max-tag-count} . The limit concerns people tagged on the media.

How do I fix Instagram error 100?

1. Count the entries in user_tags and reduce them to 20 or fewer. 2. Deduplicate usernames before building the array. 3. Check the caption separately and keep @ mentions to 20 or fewer. 4. Create a new container with the trimmed tag list.

Should I retry after error 100?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging Instagram by hand

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