Postproxy × Instagram

Publish posts, Reels, and Stories to Instagram with platform-specific parameters. Handle covers, audio, and collaborators seamlessly.

One API handles feed posts, Reels, and Stories with Instagram-specific features.

Reels

Publish Instagram Reels with custom covers, audio, and trial strategies

Stories

Share ephemeral content with Stories support

Carousel Posts

Create multi-image carousel posts up to 10 images

Collaborators

Add up to 3 collaborators to your posts and reels

POST /v1/posts
Terminal window
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": {
         "body": "New reel is live! Full tutorial on our channel 🎬"
       },
       "profiles": ["instagram"],
       "media": ["https://example.com/video.mp4"],
       "platforms": {
         "instagram": {
           "format": "reel",
           "first_comment": "Full tutorial link in bio!",
           "cover_url": "https://example.com/thumbnail.jpg",
           "audio_name": "Trending Audio Track",
           "trial_strategy": "MANUAL"
         }
       }
     }'

Instagram Parameters

Formats

Format Description
post Feed post (default)
reel Instagram Reel
story Instagram Story

Parameters

Parameter Type Required Description
format string No Set to "post" (default), "reel", or "story"
first_comment string No Comment to add after posting
cover_url string No URL of cover image for the reel
audio_name string No Name of the audio
trial_strategy string No Trial strategy for trial reels ("MANUAL" or "SS_PERFORMANCE")
collaborators array No List of collaborator usernames (up to 3 for reels)
thumb_offset string No Thumbnail offset in milliseconds

Media Constraints

Media Type Max Size Formats Max Count Duration
Image 8 MB jpg, png 10 -
Video 300 MB mp4, mov 1 3s - 60min (post), 3s - 90min (reel), 1s - 60min (story)

Notes

  • Text content: Optional (caption)
  • Media required: Yes
  • Mix video and image: Yes (carousel for posts)
  • Minimum dimensions: 200x200 pixels

View full documentation for all platform-specific features for Instagram

View documentation

Why Postproxy for Instagram?

Skip Instagram Graph API complexity

No need to handle Instagram Graph API, OAuth flows, or resumable uploads. Postproxy handles it all.

Handle rate limits automatically

Instagram rate limits are managed automatically with intelligent retry logic.

Support all formats

Publish feed posts, Reels, and Stories through one unified API.

Supported formats:
Feed postsReelsStories

Reliable delivery

Automatic retries and clear status reporting ensure your content reaches Instagram.

Frequently Asked Questions

Common questions about Instagram integration

Can I add collaborators to Instagram posts?

Yes! You can add up to 3 collaborators for Reels and regular posts using the `collaborators` parameter in the platforms object. Provide an array of collaborator usernames.

How does cover_url work for Reels?

The `cover_url` parameter allows you to set a custom cover image for your Reel. If both `cover_url` and `thumb_offset` are provided, `cover_url` takes precedence. The cover image should be a URL to a publicly accessible image.

Can I publish Instagram Stories?

Yes! Set the `format` parameter to "story" in the platforms object. Stories require media (image or video) and do not support text content in the post body.

What formats are supported for Instagram?

Instagram supports three formats: "post" (feed post, default), "reel" (Instagram Reel), and "story" (Instagram Story). Each format has different media constraints and parameter options.

Can I add a first comment after posting?

Yes! Use the `first_comment` parameter to add a comment immediately after your post is published. This is useful for adding links, hashtags, or additional context that doesn't fit in the caption.

Ready to get started?

Start with our free plan and scale as your needs grow. No credit card required.

Get startedView documentation