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:
POST /mediatakes the file as the request body.POST /media/uploadsreturns an upload URL; send the file there, then callPOST /media/{id}/complete.POST /media/importsfetches a file from a URL.
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
| Status | In Meta review |
|---|---|
| Content types | Post, Carousel |
| Caption | Up to 2200 characters |
| Carousel | 2 to 10 items |
| Image size | Up to 8 MB |
| Scheduling | From 1 minutes to 365 days ahead |