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.

Get API key — free See pricing

Free plan · No credit card · Live in under 5 minutes

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"
         }
       }
     }'

View full documentation for all platform-specific features for Facebook

View documentation
INTEGRATION COST

Skip weeks of Facebook integration work

One test post against a sandbox account is the easy part. Production Facebook publishing means app verification, OAuth across many accounts, media pipelines, dozens of edge cases, and a permanent on-call rotation for "why didn't this one go through this time?"

5 min
Time to your first Facebook post via API
Weeks → Hours
Engineering time saved on integration work
$0
Free plan, no credit card required
Build it yourself
  • Submit a Facebook app for verification — review cycles, screencasts, business docs
  • Implement OAuth, token refresh, secure credential storage per account
  • Build media upload pipelines (chunked, async, multi-step) for every format
  • Handle rate limits, quotas, retries, and partial failures across accounts
  • Cover dozens of edge cases: expired tokens, scope drift, regional restrictions, policy changes
  • Triage every silent failure: "Why didn't this one post go through?"
Ship with Postproxy
  • One REST endpoint. One payload schema. SDKs for popular languages
  • OAuth, tokens, and refresh handled for you — across all accounts
  • Media upload, chunking, and format detection — automatic
  • Retries, rate-limit windows, and per-platform receipts built in
  • Edge cases are our problem. Failures come back with an explicit reason
  • We track the API changes. You ship features
Start posting to Facebook via API See pricing

Free plan includes the Facebook API. No credit card.

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.

Get started View documentation