The Facebook scheduling API

Create a Facebook post with one HTTP call. It joins the same queue the dashboard uses, retries on failure, and reports back what actually went out.

Publish to Facebook

# POST a text-and-media post to your connected Facebook channel
curl -X POST https://api.postwharf.com/v1/posts \
  -H "Authorization: Bearer $POSTWHARF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Shipping today.",
    "channels": ["ch_your_facebook_channel"],
    "media": ["med_optional"]
  }'

Schedule it instead

curl -X POST https://api.postwharf.com/v1/posts \
  -H "Authorization: Bearer $POSTWHARF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Tuesday drop","channels":["ch_your_facebook_channel"],"publish_at":"2026-09-01T09:00:00Z"}'

Find your Facebook channel id

curl https://api.postwharf.com/v1/channels \
  -H "Authorization: Bearer $POSTWHARF_KEY"

Each connected account is a channel. The one you want has "platform": "facebook".

Check what happened

curl https://api.postwharf.com/v1/posts/post_xxx \
  -H "Authorization: Bearer $POSTWHARF_KEY"

The response carries one delivery per channel with its status, the live URL once published, and the error text if it failed. Deliveries are re-checked after publishing, so a Facebook post removed later stops reporting as live.

What Facebook accepts

63,206 characters, counting the post body. Up to 10 images or 1 video per post — Facebook does not take both in the same post.

Read from the table the API enforces, so a post over 63,206 is refused when you create it rather than truncated on the way to Facebook.

Worth knowing about Facebook

Pages only — the API cannot publish to personal profiles.

Every other network

Instagram · TikTok · X · LinkedIn · YouTube · Threads · Pinterest · Bluesky · Reddit · Telegram · Discord · Snapchat · WordPress