Platform
Instagram publishing API
Schedule and publish posts and carousels to Instagram Business and Creator accounts.
Every limit and capability on this page is read from the same catalog the API enforces, so the page and the API cannot disagree.
Instagram publishing runs through the Instagram professional account you connect. Media is prepared first and published second, and each target gets a receipt that shows every step.
Capabilities
Each capability with its current status. Planned means not available yet.
Publishing
| Capability | Status |
|---|---|
| Image posts | In Meta review |
| Carousels Meta's documentation and vendors disagree between 10 and 20 items. The limit lives in the publishing rules and stays at 10 until a live test proves 20. | In Meta review |
| Reels | In Meta review |
| Stories | Planned |
| Collaborators | Planned |
| Alt text Sent on single-image posts only: Instagram takes no alt text on carousel items or Reels. | In Meta review |
| User tags | Planned |
| Location tags | Planned |
| Trial Reels | Planned |
| AI-generated label | Planned |
| First comment | Planned |
| Delete a published post | Not supported on this login |
| Resumable video upload | Planned |
| Paid partnership label | Planned |
| Polls | Not supported on this login |
| Audio | Not supported on this login |
Inbox
| Capability | Status |
|---|---|
| Read comments | Planned |
| Mentions | Planned |
| Send direct messages | Planned |
| Private replies to comments | Planned |
Analytics
| Capability | Status |
|---|---|
| Post metrics | Planned |
| Account metrics | Planned |
| Story insights webhook | Planned |
Ads
| Capability | Status |
|---|---|
| Boost a post as an ad | Planned |
Good to know
The limits Relay Port enforces before a post is sent.
- Caption length
- Up to 2,200 characters
- Hashtag warning
- A warning above 5 hashtags
- Hashtags
- Rejected above 30
- Mentions
- Up to 20
- Carousel items
- 2 to 10
- Image aspect ratio
- 4:5 to 1.91:1
- Image width
- 320 to 1,440 px
- Image size
- Up to 8 MB
- Video
- Up to 300 MB, 3 seconds to 15 minutes
- Alt text
- Up to 1,000 characters
- Daily publishing limit
- 50 publishes in 24 hours, read live from the platform
- Hourly publishing limit
- 25 publishes per hour
Questions
- Which Instagram accounts can I connect?
- Business and Creator accounts that belong to a business portfolio. Personal accounts cannot publish through Instagram's API. You connect by logging in with Instagram or Facebook, then choosing the portfolio and the professional accounts.
- Why does the carousel limit say 10 when some vendors say 20?
- Meta's documentation and vendors disagree. We use the lower figure, which lives in the publishing rules, until a live test proves the higher one.
- Can I delete a published post through the API?
- Not on accounts connected with a Facebook login. The capability table shows which capabilities are live, in Meta review, planned or not supported.
- What happens if Instagram accepts a post and then does not answer?
- We read Instagram to find out what happened. If we still cannot tell, the target is marked unconfirmed and its receipt lists what we checked. We never send the post a second time on our own.