FacebookAPI for Pages, Reels & Stories

Publish feed posts and Stories to Facebook Pages — and manage comments and Messenger DMs from the same API. Handle first comments and multi-page management with ease.

One API for feed posts, Stories, comment moderation, and Messenger direct messages.

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

Comments

List, reply to, hide, delete, and like comments on your Page posts via the API

Direct Messages

Read and send Messenger DMs — private replies, reactions, and m.me link referrals

api.postproxy.dev
POST /api/posts 
$ curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": {
         "body": "Exciting news! Check out our latest product update."
       },
       "profiles": ["facebook"],
       "media": ["https://example.com/image.jpg"],
       "platforms": {
         "facebook": {
           "page_id": "123456789"
         }
       }
     }'
200 OK application/json 
{
  "id": "70tOkJ",
  "body": "Exciting news! Check out our latest product update.",
  "status": "scheduled",
  "draft": false,
  "source": "postproxy",
  "scheduled_at": "2026-05-04T13:37:54.546Z",
  "queue_id": null,
  "created_at": "2026-05-04T13:37:54.547Z",
  "media": [
    {
      "id": "DXfZ1m",
      "status": "pending",
      "error_message": null,
      "content_type": "image/jpeg",
      "source_url": "https://example.com/image.jpg",
      "url": null
    }
  ],
  "platforms": [
    {
      "platform": "facebook",
      "status": "pending",
      "permalink": null,
      "error": null,
      "params": {
        "page_id": "123456789",
        "format": "post"
      },
      "attempted_at": null
    }
  ]
}

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?"

Weeks of Facebook integration work compressed to hours

Social media integration is not a one-off job — it's a constant commitment. Platforms change their APIs, scopes, limits, and policies on their own schedule. Every change becomes your problem unless someone else is absorbing it.

That's exactly what Postproxy does for Facebook — and every other platform we support — so your team ships features instead of chasing failed publishes.

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
Ship with Postproxy
Submit a Facebook app for verification — review cycles, screencasts, business docs
01
One REST endpoint. One payload schema. SDKs for popular languages
Implement OAuth, token refresh, secure credential storage per account
02
OAuth, tokens, and refresh handled for you — across all accounts
Build media upload pipelines (chunked, async, multi-step) for every format
03
Media upload, chunking, and format detection — automatic
Handle rate limits, quotas, retries, and partial failures across accounts
04
Retries, rate-limit windows, and per-platform receipts built in
Cover dozens of edge cases: expired tokens, scope drift, regional restrictions, policy changes
05
Edge cases are our problem. Failures come back with an explicit reason
Triage every silent failure: "Why didn't this one post go through?"
06
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.

Benefits

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.

Feed postsStories

Publish and engage

Automatic retries and clear status for every post — plus comment moderation and Messenger DMs through the same API, with webhooks for inbound engagement.

How Postproxy publishes to Facebook

01 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.
02 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.
03 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.
04 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.
05 Comments and Messenger DMs
Facebook has the most complete engagement support of any network on Postproxy. Manage comments with list, reply, delete, hide/unhide, and like/unlike actions — and handle Messenger direct messages with text, media, reactions, and private replies to commenters. Guide conversations without building a bot UI: send tappable quick-reply chips or buttons with a Messenger DM, and each tap comes back as a webhook carrying the payload you chose, so routing is a switch statement instead of free-text parsing. Attribute conversations to campaigns with m.me link referrals: when someone enters a DM via an m.me/<page>?ref=... link, the referral is stored on the chat and a webhook fires. All comment writes are asynchronous, and inbound messages arrive via webhooks for real-time integration.

Still wondering if Postproxy is the right fit?

Ask your favorite LLM what it thinks about us, then decide.

Ask ChatGPT Ask Gemini Ask Claude Ask Perplexity

Frequently Asked Questions

Common questions about Facebook integration

01 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.

02 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.

03 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.

04 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.

05 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.

06 Does Postproxy support Facebook comments and Messenger DMs?

Yes. Postproxy offers the fullest comment management of any network — list, reply, delete, hide/unhide, and like/unlike — plus Messenger direct messages with text, media, reactions, private replies to commenters, and m.me link referrals for campaign attribution. See the Comments API and Direct Messages API for details.

Ready to get started?

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

Get started View documentation