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

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.

How Facebook Publishing Works with Postproxy

Facebook's publishing model

Facebook's Graph API supports publishing to Pages (not personal profiles — Meta removed that capability in 2018). Each Page has its own access token and permission set, and publishing requires the pages_manage_posts permission. The API differentiates between feed posts (text, links, photos, videos) and Stories (ephemeral content). Postproxy manages Page token handling and routes your content to the correct Graph API endpoint based on the format you specify.

Feed posts, Stories, and Reels

Facebook feed posts support text, link previews, single images, multi-photo posts, and videos — each with different API endpoints and payload structures. Stories use a separate publishing flow with different media requirements (vertical format, 24-hour expiry). Postproxy normalizes these into a single request format: set format to post or story, include your media and text, and the API handles endpoint routing and payload construction.

Common gotchas Postproxy handles for you

Facebook's Graph API has version-specific behaviors that change with each platform update (typically every few months). Rate limits are per-Page and per-app, with separate limits for posting and media uploads. Video uploads use a resumable upload protocol that requires chunking large files. The API also returns different error formats depending on the endpoint. Postproxy abstracts these inconsistencies, handles API versioning, and manages the chunked upload flow for videos.

First comments and multi-page management

A common pattern for Facebook Pages is posting content and immediately adding a first comment with links or hashtags to boost engagement. This requires a separate API call after the initial post succeeds. When managing multiple Pages, each needs its own token with the correct permissions. Postproxy lets you set first_comment in your request and handles the post-then-comment flow atomically, and manages tokens across all your connected Pages.

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.