Facebook API Reference

Post to Facebook Pages with text, images, video, carousels, and GIFs.

Quick reference

auth	OAuth 2.0 (Meta)
text Limit	63,206 characters
max Media	10 items (carousel)
media Rule	Text-only posts are allowed
max Video Duration	4 hours
entity Selection	Facebook Pages
first Comment	Supported — no fixed limit

Content types

✓Text

Up to 63,206 characters

✓Images

JPEG, PNG, GIF, WebP. Max 4 MB.

✓Video

MP4 or MOV. Max 4 GB.

✓Carousel

Up to 10 items

✓GIF

Animated GIFs supported natively

Media requirements

Constraints enforced by Facebook's API. Requests that violate these limits will be rejected.

Constraint	Value
Max image size	`4 MB`
Max video size	`4 GB`
Image formats	`JPEG, PNG, GIF, WEBP`
Video formats	`MP4, QUICKTIME`
Max video duration	`4 hours`
Min image dimensions	`100x100 px`
Max media items	`10`
GIF support	`Yes`

Platform settings

Pass these fields inside platformSettings.facebook in the request body.

Name	Type	Required	Description
`postType`	`string`	Optional	Type of Facebook post.Default: `post` `poststoryreelcarousel`

postType

stringOptional

Type of Facebook post.

Default: post

poststoryreelcarousel

Code examples

Basic post

curl -X POST https://schedulala.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Exciting news from our team!",
    "platforms": [
      { "platform": "facebook", "accountId": "acc_789" }
    ],
    "publishNow": true
  }'

Post with media

curl -X POST https://schedulala.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "New product launch!",
    "platforms": [
      { "platform": "facebook", "accountId": "acc_789" }
    ],
    "mediaItems": [
      { "type": "image", "url": "https://example.com/product.jpg" }
    ],
    "publishNow": true
  }'

Quirks & gotchas

Posts go to a Facebook Page, not a personal profile — you must select a Page after connecting.

Entity selection required: call GET /api/v1/connect/facebook/entities to list pages.

Video max: 4 GB. Image max: 4 MB.

Minimum image dimensions: 100x100 px.

One of the most generous text limits at 63,206 characters.

Posts API — Create and schedule posts across all platforms Media API — Platform-specific media constraints and upload limits Connecting Accounts — OAuth, App Password, and Bot Token flows All Platforms — Compatibility matrix and overview of all 12 platforms