Instagram — Postli docs

Home / Docs / Instagram

Provider

Instagram

Publish feed posts, stories, and reels to Instagram Business or Creator accounts using Meta’s Graph API for Instagram. Carousel and single-media posts are both supported.

Requirements

An Instagram Business or Creator account — personal accounts are not supported by Meta’s publishing API.
The Instagram account must be linked to a Facebook Page you administer (Meta’s Graph API requires this link).
Admin access on the Facebook Page during the OAuth grant.

Spec

Account type

Business or Creator (linked to a Facebook Page)

Auth

Meta OAuth 2.0 (Facebook Login for Business)

Token type

Long-lived user access token, 60 days. Postli refreshes automatically before expiry.

Post types

Feed (image, video, carousel), Story, Reel

Caption

Up to 2,200 characters · 30 hashtags · 20 @mentions

Image

JPEG only · 320–1440 px wide · aspect 4:5 to 1.91:1 · ≤8 MB

Video (feed)

MP4, H.264 · 3–60 s · ≤100 MB · max 1080p

Reel

MP4, vertical 9:16 · 3–90 s · ≤100 MB

Story

Image or video, 9:16 · video ≤60 s

Carousel

2–10 media items, all same aspect ratio

Auto-comments

Supported — Instant, Time, LikeCount conditions

Connect your Instagram account

Postli manages the OAuth app centrally — you don’t need to create a developer app or paste any API credentials. Go to Integrations → Instagram → Connect and approve the permissions on Facebook’s OAuth dialog. Partial grants will leave Instagram unable to publish, so approve all listed permissions.

One connect, two providers. The same Meta OAuth flow authorises both Instagram (via a linked Facebook Page) and Facebook Page publishing. If you want Instagram Direct (no Facebook Page linked), connect it as a separate integration from the Integrations page.

The scopes Postli requests:

instagram_basic # read profile instagram_content_publish # publish posts instagram_manage_comments # auto-comments instagram_manage_insights # engagement pages_show_list # list linked Pages pages_read_engagement # Page-level metrics business_management # Business Manager scope

After consent, Postli stores the long-lived token, lists your linked Instagram Business accounts, and asks you to pick which one to connect.

Post types in detail

Feed post

Standard timeline post. One image, one video, or 2–10 items as a carousel. The caption renders below the media. Use the Channel tab on a Postli post to override the master caption with Instagram-specific copy and emoji.

Story

9:16 image or video that disappears after 24 hours. Story-specific stickers (polls, questions, location) are not supported by the Graph API and therefore not by Postli. Use a static link sticker by enabling the swipe-up URL field on the Channel tab — Postli will substitute the short link.

Reel

Vertical short-form video, 3–90 seconds. The cover image field on the Channel tab lets you upload a custom thumbnail; otherwise Instagram auto-selects a frame.

Auto-comments

All three condition types work on Instagram. The most common use is to keep the link out of the caption (where the algorithm de-prioritises it) and post it as the first comment via an Instant auto-comment instead.

Story-and-link tip. The Graph API does not allow tappable links inside Reel or feed captions. Use the link-sticker field on Stories, or fall back to the “link in bio” convention — Postli’s short links work in both contexts.

Rate limits

Meta’s Graph API allows 25 published posts per Instagram account per 24 hours. Story and reel uploads count towards this. Postli respects the limit and will defer additional posts to the next 24h window with a status of queued.

Gotchas & best practices

Personal accounts won’t connect. Convert to Business or Creator in the Instagram app first (Settings → Account type and tools).
Page link is required. If your Instagram is not linked to a Facebook Page, the Graph API will return zero accounts. Link the Page in Meta Business Suite.
JPEG only for images. PNGs are rejected by the publishing endpoint — convert before uploading.
Aspect ratio mismatch in carousels is the #1 publish failure. All carousel items must share the same ratio.
Token re-auth. If the merchant changes their Facebook password, all tokens are invalidated. Postli will surface a re-auth banner under Account health.

Webhooks

Postli does not currently subscribe to Instagram webhooks for inbound events — engagement is polled on a schedule (see How publishing works).