Instagram Messaging API · error code

Instagram error 100: Carousel has too few or too many items (2207028)

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

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
Your post won't work as a carousel. Carousels need at least 2 photos/videos and no more than 10 photos/videos.

What error 100 means

Code 100 with subcode 2207028 is raised when a carousel container's children list has the wrong number of items. The literal message names a minimum of 2 and a maximum of 10, and Meta's recommended solution is simply to try again with an acceptable number of photos and videos.

Be aware that Meta's documentation is not consistent on the upper bound. The current content publishing guide and the IG User media reference both say carousels can hold up to 20 images, videos or a mix, while this error's message text still reads 10. The minimum of 2 is not in dispute. If you send between 11 and 20 children and still get this error, treat 10 as the working limit for that request.

Other carousel rules interact with the count: reels cannot appear in carousels, and each child must be an image or video container created with is_carousel_item=true. A child that failed or expired can silently shrink the effective list.

What it looks like

{
  "error": {
    "type": "OAuthException",
    "code": 100,
    "error_subcode": 2207028,
    "error_user_msg": "Your post won't work as a carousel. Carousels need at least 2 photos/videos and no more than 10 photos/videos.",
    "fbtrace_id": "MnR7bKq4VhYs1Xe"
  }
}

Why it happens

  • The children list contains only one container ID.
  • More children were sent than the account currently accepts.
  • The children parameter was sent as a malformed string, so fewer IDs were parsed than intended.
  • One or more child containers failed or expired, leaving too few valid items.

How to fix Instagram error 100

  1. 1Count the IDs in children and keep the list between 2 and 10 to be safe, or up to 20 where that limit is confirmed.
  2. 2Send children as a comma-separated list of container IDs with no stray spaces or brackets.
  3. 3Check every child's status_code and rebuild any that are not FINISHED.
  4. 4Recreate children for reels as regular video items, since reels are not allowed inside carousels.
  5. 5Create the carousel container again with the corrected list.

How to stop it recurring

Validate carousel size in your composer and again before creating the parent container, using the conservative bound unless you have confirmed 20 works for your accounts. Create children with is_carousel_item=true, wait for each one to finish, and only then assemble the parent. A single carousel counts as one post toward the publishing quota.

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 2207028 is raised when a carousel container's children list has the wrong number of items. The literal message names a minimum of 2 and a maximum of 10, and Meta's recommended solution is simply to try again with an acceptable number of photos and videos. Be aware that Meta's documentation is not consistent on the upper bound.

How do I fix Instagram error 100?

1. Count the IDs in children and keep the list between 2 and 10 to be safe, or up to 20 where that limit is confirmed. 2. Send children as a comma-separated list of container IDs with no stray spaces or brackets. 3. Check every child's status_code and rebuild any that are not FINISHED . 4. Recreate children for reels as regular video items, since reels are not allowed inside carousels. 5. Create the carousel container again with the corrected 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.