Platforms

Facebook

Facebook over the overads API: status, connection, limits, media rules and platformSettings keys.

Status: Live. Posts created over the API deliver to this channel today.

Live since Meta's App Review approved pages_manage_posts on 2026-10-13. Posts go to a Page the person manages; delivery reads the grant on each connection, so a Page connected before the approval may need to reconnect.

Connecting#

OAuth through the Meta sign-in, in the app. Posts go to a Page the user manages.

Once connected the account appears in GET /connections with platform: "facebook". Use its id in connectionIds.

Limits#

• Up to 10 images, or 1 video up to 1 GB and 20 minutes.
• Media is optional.

Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. These refusals answer 400 with the flat body { statusCode, code, message }, not the { error } envelope: TOO_LONG, TOO_MANY_ITEMS, MEDIA_UNSUPPORTED, MEDIA_REQUIRED, MEDIA_TOO_LARGE (over the channel's video size cap), MEDIA_TOO_LONG (over its duration cap). The full list is under Channel-limit refusals.

Settings#

Pass these under platformSettings.facebook. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.

{ "facebook": { "firstComment": "Full write-up: https://overads.io/blog" } }