Instagram

Instagram supports images, videos, albums, and stories. Posts are published to your connected Instagram Business or Creator account.

Post types

Type	API value	What it publishes
Image	image	One image with a caption.
Video	video	One video with a caption, published as a Reel.
Album	album	A carousel of 2 to 10 items with a caption. Images and videos can be mixed.
Story	story	One image or video published to Stories. No caption.

Media requirements

Images

• Formats: JPEG, WebP.
• File size: up to 8 MB per image.
• Aspect ratio: between 4:5 (portrait) and 1.91:1 (landscape). 1:1 also works.

Videos

• Formats: MP4, MOV with H.264 or HEVC video and AAC audio.
• File size: up to 1 GB.
• Duration: 3 seconds to 15 minutes.
• Bitrate: up to 25 Mbps.
• Aspect ratio: 9:16 is recommended for Reels.

Stories

• Images: JPEG, WebP, up to 8 MB. 9:16 (1080 × 1920 px) is recommended.
• Videos: MP4, MOV, up to 1 GB, 3 to 60 seconds, 9:16 recommended.
• Keep text and faces away from the top and bottom 250 px, where Instagram shows the profile and reply bar.

Text limits

• Caption (description): up to 2,200 characters.
• Up to 30 hashtags and 20 @mentions per caption.

Extra options

Option in the dashboard	API field	Applies to	What it does
Share to Feed	additionalInfo.isShareToFeed	Video	Also shows the Reel on your profile grid.
Collaborators	additionalInfo.collaborators	Image, Video, Album	Invites up to 3 accounts, by username, to co-author the post.
Mentions	additionalInfo.mentions	Story	Mentions up to 3 accounts, by username, in the story.
Custom Thumbnail	medias[].thumbnail, medias[].customThumbnail	Video	Uses your own image as the Reel cover.