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 (as granted): instagram_basic, instagram_content_publish (as granted via Meta connection)

Common fields

• type - IMAGE, VIDEO, or REEL (default IMAGE).
• mediaUrls - Required media URL(s).
• url - Optional fallback for mediaUrls.
• text / caption - Optional caption.
• instagramAccountId - Optional connected professional account ID.
• proxyDownload - Required pattern for Drive links; auto for Drive/Dropbox.

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.