The API reference moved here from eksis.io/developers.

Instagram

Instagram publishes feed, carousel, reels and story. Every post needs media, so there are no text-only posts. Media accepted: images and video. Comments can be read, and you can reply, hide and delete them. Direct messages can be read and answered. A commenter can be answered privately by DM. Post metrics are available. A first comment can be posted right after publishing. eksis publishes at most 25 posts per account per rolling 24 hours.

Post types

TypeAPI valueWhat it publishesMedia itemsAccepts
FeedfeedOne image or video in the feed. A video goes out as a Reel.1Images or video
CarouselcarouselSeveral images or videos in one swipeable post.2 to 10Images and video, mixed
ReelsreelsOne vertical video as a Reel.1Video
StorystoryOne image or video shown for 24 hours. The caption is not sent.1Images or video

Media requirements

Feed (feed)

  • Images: up to 8 MB, aspect ratio 3:4 to 1.91:1, 320 to 1440 px wide.
  • Video: up to 1 GB, 3 s to 15 min long, aspect ratio 1:2 to 1.91:1.
  • Images: up to 8 MB, aspect ratio 3:4 to 1.91:1, 320 to 1440 px wide.
  • Video: up to 1 GB, 3 s to 15 min long, aspect ratio 1:2 to 1.91:1.

Reels (reels)

  • Video: up to 1 GB, 3 s to 15 min long, aspect ratio 1:2 to 9:16.

Story (story)

  • Images: up to 8 MB, aspect ratio 1:2 to 9:16.
  • Video: up to 100 MB, 1 s to 1 min long, aspect ratio 1:2 to 9:16.

Text limits

FieldLimitUnitNote
caption30itemsHashtags per caption.
firstComment2,200characters

Settings

Options for Instagram go in targets[].settings of create and update post requests.

eksis optionFieldTypeValuesRequiredApplies to
Cover image: Public address of an image to use as the Reel cover.settings.coverUrlstringNoreels
Share to feed: Also show the Reel on the profile grid.settings.shareToFeedbooleanNoreels
Location: Facebook Page id of a place to tag in the post.settings.locationIdstringNofeed, reels
Crop: Shape that photos in a feed post or carousel are cropped to from the center: 1:1, 4:5, 3:4, or 16:9. Left out, eksis picks the shape closest to the first photo.settings.cropstring1:1, 4:5, 3:4, 16:9Nofeed, carousel

A value of the wrong type, or outside the allowed values, is refused with 422 and the code validation.failed, drafts included. An unknown key is dropped and reported in data.warnings.

Example target
{
  "channelId": "CHANNEL_ID",
  "contentType": "feed",
  "settings": {
    "shareToFeed": true,
    "crop": "4:5"
  }
}

Comments and messages

  • First comment: supported.
  • Comments: read, reply, hide and delete.
  • New comments reach eksis: pushed by Instagram and checked every 10 minutes.
  • Private reply to a comment: supported.
  • Direct messages: read and reply.

Analytics

  • Post metrics: reach, likes, comments, shares, saves, profileVisits.
  • Audience: follower count is tracked.

Daily limit

eksis publishes up to 25 posts per Instagram channel a day. Instagram itself allows 100 posts per account a day. A post over the limit is postponed, not failed.

Good to know

  • Only Business and Creator accounts linked to a Facebook Page can publish. Personal accounts are refused when connecting.
  • A feed post with a video is published as a Reel.
  • Instagram processes media after upload. A post still processing after 5 minutes fails.

Webhook events

Events a Instagram channel can send to your webhook endpoints:

Rules verified on September 5, 2026.

On this page