Instagram error 100: Unknown media type (2207023)
Last verified against Meta for Developers - Messenger Platform error codes
The media type {media-type} is unknown.What error 100 means
Code 100 with subcode 2207023 means the media_type value on your container request is not one Instagram recognizes. Meta's recommended solution is to enter one of the expected media types. The message echoes back the value it rejected, which usually makes the bug obvious.
The accepted values depend on what you are publishing. The content publishing guide says to set media_type to VIDEO, REELS or STORIES for video containers and to CAROUSEL for a carousel parent. Single feed images take no media_type at all - an image_url alone is enough. Values like IMAGE, PHOTO, REEL, STORY or CAROUSEL_ALBUM are common mistakes. The last one is especially easy to make because CAROUSEL_ALBUM is what Instagram returns when you read a published media object, but it is not what you send when creating one.
Casing and whitespace matter too. Treat the value as an exact enum, not free text.
What it looks like
{
"error": {
"type": "OAuthException",
"code": 100,
"error_subcode": 2207023,
"error_user_msg": "The media type CAROUSEL_ALBUM is unknown.",
"fbtrace_id": "NpS2dLr8WjZu4Af"
}
}Why it happens
- The app sent a read-side value such as CAROUSEL_ALBUM or IMAGE when creating a container.
- The value was singular or misspelled, for example REEL or STORY.
- The value was lowercase or had trailing whitespace from a form field.
- A media_type was supplied for a plain feed image where none is needed.
How to fix Instagram error 100
- 1Read the rejected value in the error message.
- 2Use exactly
REELS,STORIES,VIDEOorCAROUSELas appropriate for the container. - 3Omit
media_typeentirely for a single feed image sent withimage_url. - 4Map your internal post types to these constants in one place instead of passing user input through.
- 5Create the container again with the corrected value.
How to stop it recurring
Define the write-side media types as constants in a single mapping layer and keep them separate from the read-side values you get back from the media endpoints. Add a unit test that every post type your composer offers maps to a valid container request. Carousel structure is validated separately, as 100/2207028.
Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.
Related codes
- 100: Carousel has too few or too many items (2207028)Your post won't work as a carousel. Carousels need at least 2 photos/videos…
- 100: Invalid parameterBad Parameter Error: Invalid FBID.
- 352: Video format is not supported (2207026)The video format is not supported. Please check spec for supported {video}…
Error 100 - quick answers
What does Instagram error 100 mean?
Code 100 with subcode 2207023 means the media_type value on your container request is not one Instagram recognizes. Meta's recommended solution is to enter one of the expected media types. The message echoes back the value it rejected, which usually makes the bug obvious. The accepted values depend on what you are publishing.
How do I fix Instagram error 100?
1. Read the rejected value in the error message. 2. Use exactly REELS , STORIES , VIDEO or CAROUSEL as appropriate for the container. 3. Omit media_type entirely for a single feed image sent with image_url . 4. Map your internal post types to these constants in one place instead of passing user input through. 5. Create the container again with the corrected value.
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.