Instagram | Chirio Docs


Caption limit	2,200 characters
Media	1–10 items, required. Images must be JPEG
Carousel	2–10 items
First comment	yes, up to 2,200 characters
Connection lasts	60 days, refreshed automatically
Rate limit	100 posts per account per 24 hours
Units per write	1

What the user needs

The account must be professional

Instagram only allows publishing from Business or Creator accounts. A personal account can complete the connect flow and then fail at publish time, so check this before sending someone through.

Switching is free and takes a moment in the Instagram app: Settings → Account type and tools → Switch to professional account.

Publishing behaviour

Single image — publishes as a normal post. Must be JPEG; PNG and WebP are refused by Instagram. Single video — publishes as a Reel. That is Instagram's own behaviour, not a choice Chirio makes. 2–10 items — a carousel, in the order you send them. Video items are allowed alongside images. If any single item fails to process, the whole target fails — there is no partial carousel. See Carousels. Media is fetched by Instagram from the URL you provide, so it must stay publicly reachable until the call returns.

First comments

Supported, up to 2,200 characters, posted from the same account right after the post goes live. If a comment fails with a permission error, the connection predates Instagram's comment permission. Reconnecting the account fixes it — the failure message says so explicitly.

Common failures

Symptom	Cause
Publish fails on a valid-looking image	Not JPEG
`invalid_post`, media required	Instagram cannot post text alone
Comment fails on permissions	Connection predates comment permission — reconnect
Rate limited	100 posts per account per 24 hours is Instagram's cap, not Chirio's
Account `expired`	The 60-day credential lapsed — reconnect