step by step
How to post to Facebook with the API
Create a key, connect Facebook, then schedule a post.
Open Dashboard → AI & API, create a key, and send it as Authorization: Bearer pw_live_…. Connect your Facebook account if you have not already.
Endpoints
API base URL
https://postwing.io/api/v1Docs
https://postwing.io/docsCall POST /posts/preview with a caption, time, platforms: ["facebook"], and media. Full field reference is in the API docs.
curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "New Reel from the Facebook posting API",
"scheduled_at": "2026-10-05T18:00:00Z",
"targets": [
{
"account_id": "facebook-account-uuid",
"platform_options": {
"placement": "reels"
}
}
],
"media_items": [
{
"url": "https://cdn.example.com/reel.mp4",
"type": "video"
}
]
}'what you can do
Facebook posting from one API
Same PostWing API as the full product, scoped to Facebook when you set platforms to facebook.
- Schedule Facebook feed posts and Reels
- Upload images and videos with a direct upload URL
- Choose timeline or reels placement for video
- Preview → confirm so nothing schedules without approval
- Edit or cancel scheduled Facebook posts from the same API
built for Facebook
Feed posts and Reels in one flow
Upload media, set a caption, pick a time, and target Facebook. For video, choose timeline or reels placement.
- Images publish to the Facebook feed
- Videos default to Reels; set placement when you need the timeline
- Scheduled posts show up on your PostWing calendar
Facebook options
Platform settings that matter
Pass these on targets[].platform_options when you need more control.
placementtimeline or reels (video defaults to reels)- Preview → confirm so nothing schedules without approval
- API key or OAuth with scoped access
one API
Same API for every network
There is no separate Facebook product. Pass platforms or targets[] on the same preview → confirm flow. Add Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, or Threads without changing your integration.
- X (Twitter)
- Threads
- YouTube
- TikTok
Connect accounts once in PostWing (or via the accounts endpoints)
Call POST /posts/preview with the networks you want on that post
Confirm with the token. One key covers every platform PostWing supports.
questions
Facebook posting API FAQ
Yes. Upload a video and set placement to reels (the default for video), then preview and confirm.