Skip to content
Relay Port

Instagram

Publishing to Instagram

Content types, captions and media, the checks every post passes before anything is sent, and the publishing budgets Instagram sets per account.

An Instagram target publishes what its platformData.instagram.contentType names:

contentType What it publishes
image One JPEG image as a feed post.
carousel Several images in one post.
reel One video. Its capability is not generally available yet, so check GET /accounts/{id}/capabilities before you rely on it.

The numbers that apply today, from the platform catalog, are in the table under this guide. GET /platforms/instagram returns the full rules as data.

Every post is checked first

Creating a post runs Instagram's rules on every target: caption length, hashtags and mentions, the number of carousel items, image format, size and shape, and video size and length. If any target breaks a rule, nothing is created and the answer is 422 PostValidationFailed with every issue in details.issues, each naming its target, field and rule.

POST /posts/validate takes the same body as POST /posts and returns the issues and warnings without saving anything. Some rules only warn, such as Instagram's lower hashtag limit in its own app; warnings come back in warnings and never block the post.

Media

Upload media before you create the post, then attach it by mediaId:

Each file is checked when it arrives, and the media.ready or media.failed event tells you the result.

How a post goes out

Instagram publishes in two steps: it prepares the media in a container, then publishes the container. Relay Port prepares the media before the due time, so the publish call itself is made on time, and then reads the outcome back from Instagram. Every step is in the target's timeline, GET /posts/{id}/events.

When Instagram's answer to the publish call is lost or ambiguous, Relay Port does not send it again. It checks the account and records what it found: see Unconfirmed targets.

Publishing budgets

Instagram limits how many posts one account can publish in a day. Relay Port keeps each account inside an hourly and a daily budget below Instagram's own, and reads the live quota Instagram reports. GET /accounts/{id}/limits returns the budgets, how much of each is used, and the last rate pressure Instagram reported.

Deleting a published post

Instagram's API does not let Relay Port delete a post published through this sign-in, so POST /posts/{id}/unpublish answers 501 NotSupported and names the reason for each target. Delete the post in Instagram itself.

Rules by platform

Instagram
StatusIn Meta review
Content typesPost, Carousel
CaptionUp to 2200 characters
Carousel2 to 10 items
Image sizeUp to 8 MB
SchedulingFrom 1 minutes to 365 days ahead