Connect
Requires an Instagram Business or Creator account linked to a Facebook Page.Post types
| Type | Endpoint | Media |
|---|---|---|
| Image | POST /unified/post/image | default_image_id or default_image_url |
| Carousel | POST /unified/post/carousel | image_ids (2–20) |
| Video | POST /unified/post/video | video_id or video_url |
Example: image post
Caption limit
Instagram captions are capped at ~2,200 characters. Postsiva validates at 2,200 and returns422 if exceeded:
Media requirements
Instagram has strict aspect ratio rules. Postsiva auto-fits images to allowed ratios (letterboxing) on upload when needed.| Format | Guidance |
|---|---|
| Image | JPEG/PNG; 4:5 to 1.91:1 aspect ratio recommended |
| Carousel | 2–20 images, same aspect ratio per slide |
| Video | MP4/MOV; Reels-compatible dimensions |
Scheduling
POST /unified/scheduled-posts for schedule-only requests.
Multi-platform posting
Instagram pairs well with Facebook and Threads in one call:Common errors
| Error | Cause | Fix |
|---|---|---|
NOT_CONNECTED | Instagram not linked | Connect Business account via OAuth |
422 caption limit | Over 2,200 characters | Shorten caption |
| Missing media | No image/video ID | Upload via /media/* first |