Facebook posting API for Page Reels and photo posts

What gets published

Facebook publishing works on Pages, not personal profiles. Meta's APIs don't allow apps to post to a personal timeline.

Facebook Reels specs to plan for

Meta's Reels publishing docs list these specs for Page Reels. Check your exports against them before you schedule a big batch.

• Aspect ratio 9:16, recommended 1080x1920, minimum 540x960.
• Duration 3 to 90 seconds. Reels shared as Page Stories are capped at 60 seconds.
• MP4 with H.264 or H.265, 24 to 60 fps.
• Meta states a limit of 30 API-published Reels in a rolling 24 hours.

Each account in a post has its own result. If Facebook rejects a clip that is too long, the other platforms still publish and the Facebook result shows platform_rejected. Read the errors reference for the full list.

One call for every placement

curl https://ugcapi.dev/v1/posts \
  -H "Authorization: Bearer ugc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": ["acc_fb_page_01", "acc_ig_01", "acc_tt_01"],
    "format": "video",
    "media": ["https://cdn.example.com/review-07.mp4"],
    "caption": "Honest review after two weeks",
    "options": { "facebook": { "story": false }, "instagram": { "grid": true } }
  }'

This publishes a Facebook Reel, an Instagram Reel and a TikTok video. It uses 3 credits, one per account. The UGC video API page explains the format in depth.

Connecting a Page

1. Call POST /v1/accounts/connect with platform: 'facebook' and your own external_id.
2. The Page admin logs in with Facebook and selects the Pages to connect.
3. Each Page shows up as its own account in GET /v1/accounts.

If the admin later removes access, you get an account.disconnected webhook so you can send a fresh connect link.

Pricing

Each Facebook placement to one Page is one post credit, the same as every other platform. $10 per 1,000 posts. See pricing.