Instagram Publishing Docs

Publish Instagram images and Reels to professional accounts with Postifys: container/resumable upload notes, fields, and examples.

Last updated: 2026-07-24 · Technical source: live Postifys API behavior and API reference

What Postifys supports

Images and Reels/videos to connected Instagram professional accounts.

Product overview: Instagram integration. Full field reference also lives on API docs.

Endpoint

POST /api/instagram/post · Auth: API key or session · Target field: instagramAccountId when needed

Permissions / scopes: instagram_business_basic, instagram_business_content_publish (Instagram Business Login via /auth/instagram/start)

Common fields

• type - IMAGE, VIDEO, REEL, or STORIES (alias STORY; default IMAGE). Stories need META_STORIES_ENABLED on the server.
• mediaUrls - Required media URL(s).
• url - Optional fallback for mediaUrls.
• text / caption - Optional caption (ignored by Meta for Stories).
• instagramAccountId - Optional connected professional account ID.
• proxyDownload - Required pattern for Drive links; auto for Drive/Dropbox.

Stories honesty: professional accounts; plain media only; no stickers/polls/music via API; expire ~24h.

cURL example

curl -X POST https://postifys.com/api/instagram/post \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "REEL",
    "mediaUrls": ["https://example.com/reel.mp4"],
    "text": "New reel",
    "instagramAccountId": "INSTAGRAM_ACCOUNT_ID"
  }'

Limitations

• Personal Instagram accounts are not supported.
• Reels/videos often use Meta resumable upload after download.
• Drive files must be shared as Anyone with the link when using proxy mode.

See also Media requirements, Errors, and Rate limits.