Postproxy × Facebook

Publish feed posts and Stories to Facebook Pages. Handle first comments and multi-page management with ease.

One API call handles feed posts and Stories with Facebook-specific features.

Feed Posts

Publish to Facebook Pages with text, images, and videos

Stories

Share ephemeral Stories with images or short videos

First Comments

Add first comment immediately after posting for better engagement

Page Management

Post to specific Pages when managing multiple pages

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": "Exciting news! Check out our latest update."
       },
       "profiles": ["facebook"],
       "media": ["https://example.com/image.jpg"],
       "platforms": {
         "facebook": {
           "format": "post",
           "first_comment": "What do you think? Let us know!",
           "page_id": "123456789"
         }
       }
     }'

Facebook Parameters

Formats

Format Description
post Feed post (default)
story Facebook Story

Parameters

Parameter Type Required Description
format string No Set to "post" (default) or "story"
first_comment string No Comment to add after posting
page_id string No Page ID when you have multiple pages

Media Constraints

Media Type Max Size Formats Max Count Duration
Image 10 MB jpg, png, gif, webp 10 -
Video 4 GB mp4, mov 1 1s - 4 hours (post), 3s - 60s (story)

Notes

  • Text content: Optional (post), Not allowed (story)
  • Media required: No (post), Yes (story)
  • Mix video and image: No
  • Minimum dimensions: 500x500 pixels (story)

View full documentation for all platform-specific features for Facebook

View documentation

Why Postproxy for Facebook?

Skip Facebook Graph API complexity

No need to handle Facebook Graph API, OAuth flows, or page access tokens. Postproxy handles it all.

Handle rate limits automatically

Facebook rate limits are managed automatically with intelligent retry logic.

Support all formats

Publish feed posts and Stories through one unified API.

Supported formats:
Feed postsStories

Reliable delivery

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

Frequently Asked Questions

Common questions about Facebook integration

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 engagement, adding links, or providing additional context.

How do I publish Facebook Stories?

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

Can I post on behalf of a Facebook Page?

Yes! Use the `page_id` parameter to specify which Page to post to when you have multiple pages connected. If omitted, Postproxy will use the first connected page.

What media formats are supported?

Facebook supports images (jpg, png, gif, webp) up to 10 MB and videos (mp4, mov) up to 4 GB. Feed posts can have up to 10 images, while Stories support 1 image or video.

Can I mix videos and images in a single post?

No, Facebook does not allow mixing videos and images in a single post. You can either post multiple images (carousel) or a single video.

Ready to get started?

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

Get startedView documentation