Platforms

Instagram

Instagram over the overads API: status, connection, limits, media rules and platformSettings keys.

Status: Awaiting Meta approval. Connectable, not publishing for customers.

Built and connectable, but it does not publish for customers today. Meta declined instagram_content_publish at App Review on 2026-07-28; the composer greys the destination out and the API refuses delivery until the grant lands. Publishing works only for accounts holding a role on the overads Meta app, which is why the product reads the live grant per connection instead of hardcoding the answer.

Connecting#

OAuth through the Meta sign-in, in the app. Requires an Instagram professional account linked to a Facebook Page.

Once connected the account appears in GET /connections with platform: "instagram". Use its id in connectionIds.

Limits#

• At least one image or video is required; a text-only post is refused with MEDIA_REQUIRED.
• Up to 10 images, or 1 video up to 1 GB and 15 minutes.
• videoType picks Reels or Stories for a video.

Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. A video over the channel's size cap is MEDIA_TOO_LARGE; over its duration cap is MEDIA_TOO_LONG.

Settings#

Pass these under platformSettings.instagram. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.

{ "instagram": { "videoType": "REELS", "shareToFeed": true, "firstComment": "Link in bio." } }

A post to a channel that is not live is accepted and stored, and its target row records the refusal at delivery time. Do not schedule customer-facing posts there until this page says live.