Log inStart Free Trial
easyCoexistence Official APIs

Instagram error 2207010: caption too long

Instagram error 2207010, returned with code 36004, means the caption is longer than Instagram allows. Meta's error lists the caption limits as 2,200 characters, 30 hashtags and 20 @ tags, though Instagram's Help Center allows only 5 hashtags on a post, and hashtags and mentions count toward the 2,200 characters. Shorten the caption, then create the container again with the new text.

easyCoexistence publishes photos, carousels and Reels with their captions through publish_instagram_post, from Claude, ChatGPT or your own code.

36004

The error code returned with subcode 2207010, when a caption is over the maximum length.

2,200

Characters a caption can hold when media is published through the API.

30 and 20

The most hashtags and @ tags one caption can carry.

2207040

The separate subcode, under code 100, for more than the maximum of 20 @ tags.

What does error 2207010 mean?

The caption sent with the media is over Instagram's limit. Meta's user message gives the caption's length in characters and the maximum permitted, then asks for media with a shorter caption, and Meta's fix lists the three caption limits together: 2,200 characters, 30 hashtags and 20 @ tags.

The error concerns the caption alone, so only the text has to change before the container is created again.

What are the caption limits?

Meta's reference for creating media sets three limits, and a caption has to meet all of them:

  • 2,200 characters in all, hashtags and @ mentions included.
  • 30 hashtags.
  • 20 @ tags. Going over this one returns subcode 2207040, under code 100, rather than 2207010.
  • Accounts @mentioned in the caption are notified when the post is published.

Which posts take a caption?

Photos, Reels and carousels. In a carousel, the caption is set once on the carousel container, and the photos and videos inside it take none of their own. Meta's reference describes no caption for Stories. So the limits apply once per post, however many items a carousel holds.

How do you fix it?

Count before you send. Check the caption's length in characters along with its hashtags and @ tags, cut what is over, and create the container again with the new text. If an AI writes the captions, put the limits in its instructions, so the text arrives within them rather than failing when the post is created.

Common mistakes

  • Counting words instead of characters. The limit is 2,200 characters, which a caption of a few hundred words can pass.
  • Adding hashtags after checking the length. They count toward the 2,200 characters as well as toward the limit of 30.
  • Treating too many @ tags as a length problem. Over 20 @ tags returns 2207040, and only removing tags fixes it.
  • Retrying with the same text. The caption is checked again on every attempt, so it fails until it is shorter.
Doing this with EasyCoexistence

It refuses a caption over 2,200 characters before sending it, giving the length, and passes on Meta's message when Instagram refuses a caption for its @ tags, so your AI can shorten the text and publish again. 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 is the maximum caption length on Instagram's API?

2,200 characters, with no more than 20 @ tags. Meta's API reference lists 30 hashtags, but Instagram's Help Center allows 5 on a post, so keep to 5.

Do hashtags count toward the 2,200 characters?

Yes. Hashtags and @ mentions are part of the caption text, so they use up characters as well as counting toward their own limits.

What happens with more than 20 @ tags?

The request fails with code 100 and subcode 2207040, and Meta advises using fewer @ tags. Remove tags until there are 20 or fewer.

Can a Story have a caption through the API?

No. Meta's reference describes captions for photos, videos and carousels and none for Stories, and publish_instagram_post sends a Story without one.

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