Log inStart Free Trial
easyCoexistence Official APIs

Publishing Instagram Reels through the API

Instagram's API publishes a Reel from an MOV or MP4 file at a public URL: create a container with media_type REELS, wait while Meta processes the video, then publish it. A Reel runs from 3 seconds to 15 minutes and up to 300 MB, and Meta recommends a 9:16 frame to avoid cropping or blank space.

easyCoexistence publishes Reels with publish_instagram_post from Claude, ChatGPT or your own code: give it the video URL and the caption, and while the video is still processing it finishes publishing on its own.

15 min

Longest Reel the API publishes; the shortest is 3 seconds.

300 MB

Largest Reel file, as MOV or MP4 with H.264 or HEVC video and AAC audio.

1 min

How often Meta suggests checking a processing container's status, for no more than 5 minutes.

24 hours

How long a Reel container can wait unpublished before it expires.

How is a Reel published?

In three steps. First, POST /<IG_ID>/media with media_type set to REELS, video_url pointing at the file and, if you want one, a caption; Meta fetches the video and returns a container ID. Second, wait while Instagram processes the video, checking the container's status_code. Third, POST /<IG_ID>/media_publish with creation_id set to the container ID, and the response carries the new media ID.

Meta documents its resumable upload, which can send a file from a computer, only for setups built on Facebook Login for Business, Unified Login included. With Instagram Login, the video always comes from a public URL.

What are the video requirements?

Meta's specification for Reels, which a file has to meet before Instagram will process it:

  • Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, with the moov atom at the front of the file.
  • Video: H.264 or HEVC, progressive scan, closed GOP, 4:2:0 chroma subsampling, 23 to 60 frames per second, up to 1920 pixels wide and 25 Mbps.
  • Audio: AAC, up to 48 kHz, mono or stereo, at 128 kbps.
  • Aspect ratio: anything from 0.01:1 to 10:1, with 9:16 recommended.
  • Length and size: 3 seconds to 15 minutes, up to 300 MB.

What happens while the video processes?

The container's status_code reads IN_PROGRESS until Instagram has processed the video, then FINISHED, and only then can it be published. Publishing earlier fails with code 9007, subcode 2207027, which means wait rather than fix. Meta suggests checking the status once a minute for no more than 5 minutes.

ERROR means the container failed to complete processing, and EXPIRED means it sat unpublished for 24 hours; both need a new container. PUBLISHED means the Reel is already live.

Which Reel options does the API offer?

Beyond the video and the caption, Meta's Reel container takes these parameters:

  • share_to_feed: true lets the Reel appear in the Feed as well as the Reels tab, false keeps it to the Reels tab. Neither value guarantees a place in the Reels tab.
  • cover_url: a JPEG of up to 8 MB used as the Reels tab cover, cropped to the middle 9:16, and to a square when shared to the Feed.
  • thumb_offset: the frame, in milliseconds, used as the thumbnail when there is no cover; 0 is the first frame.
  • audio_name: a name for the Reel's audio, which can be set only once.
  • trial_params: publishes a trial Reel, shared only with people who do not follow the account until it graduates.

What else applies to a Reel?

A few rules follow a Reel from the moment its container is created.

  • A Reel cannot be a carousel item; it is always published on its own.
  • The account's privacy settings apply on publish: with Allow remixing on, the new Reel allows remixing too.
  • Music tagging is available for original audio only.
  • Read back later, a Reel reports media_type VIDEO, like any other video.
  • It counts as one post toward the account's 100 API-published posts in 24 hours.

Which metrics does a Reel report?

Through the media insights endpoint, a Reel reports reach, views, likes, comments, saved, shares, total_interactions and reposts, plus three metrics of its own: ig_reels_avg_watch_time, ig_reels_video_view_total_time and reels_skip_rate, the share of views that skipped within the first 3 seconds. Likes, comments and views count organic activity only, and the data behind them can lag by up to 48 hours.

Common mistakes

  • Publishing the moment the container is created. Wait until status_code reads FINISHED, or the call fails with subcode 2207027.
  • Sending a WebM or AVI file. Reels must be MOV or MP4, or Meta refuses them with code 352, subcode 2207026.
  • Expecting share_to_feed to put the Reel in the Reels tab. It only adds the Feed; Instagram decides what the Reels tab shows.
  • Leaving a container unpublished overnight. It expires 24 hours after creation, and publishing then needs a new one.
Doing this with EasyCoexistence

Reels can also be scheduled from its own queue. 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

How long can a Reel be through the API?

From 3 seconds to 15 minutes, as an MOV or MP4 file of up to 300 MB.

Can I upload a Reel from my computer?

Not with Instagram Login. The API fetches the video from a public URL, so put the file somewhere that gives it a public link first.

Does a Reel published through the API also appear in the Feed?

It can. The share_to_feed parameter decides whether the Reel may appear in the Feed as well as in the Reels tab.

Why does publishing a Reel fail with 9007?

Instagram is still processing the video. Check the container's status_code and publish once it reads FINISHED; nothing in the request needs fixing.

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