Facebook supports text-only posts, image posts, multi-image posts, and video posts. Posts are published to your connected Facebook Page.
Media Constraints
| Constraint | Images | Videos |
|---|---|---|
| Formats | JPEG, PNG | MP4 (H.264 + AAC) |
| Max file size | 25 MB | 4 GB |
| Max count per post | 10 | 1 |
| Max duration | n/a | 4 hours |
| Text-only posts | Supported | Supported |
| Mix images + video | Not allowed | Not allowed |
Platform Settings
All optional, under platform_settings.facebook. Leave the object out for a plain post.
| Parameter | Type | Description |
|---|---|---|
collaborator_page_ids | string[] | Up to 10 numeric Facebook Page IDs to invite as collaborators. Used only when the post is a single vertical (9:16) video, which Quegly then publishes as a Reel (Facebook Reels run 3 to 90 seconds); ignored on other posts. Send IDs, not Page names or handles. |
add_to_story | boolean | Also post the photos and videos to the Page's story once the post is out, one story frame each, in order. Needs a photo or a video. A story shows no caption and lasts 24 hours. Story videos run 3 to 60 seconds; story photos are up to 10 MB. Defaults to false. |
story_only | boolean | Post to the Page's story alone, with no feed post. Turns add_to_story on. No collaborator_page_ids. Defaults to false. |
Example: a Reel with a collaborator Page
{
"type": "schedule",
"scheduled_at": "2026-10-01T14:00:00.000Z",
"caption": "Our first collab with the team across the street.",
"media_ids": ["vertical-video-id"],
"account_ids": ["facebook-account-id"],
"platform_settings": {
"facebook": {
"collaborator_page_ids": ["104785352000000"]
}
}
}Example: Text-only Facebook post
{
"type": "schedule",
"scheduled_at": "2026-06-01T14:00:00.000Z",
"caption": "Exciting news! Check out our latest room designs.",
"account_ids": ["facebook-account-id"]
}Example: Facebook post with images
{
"type": "now",
"caption": "Before and after transformation #homedecor",
"media_ids": ["image-id-1", "image-id-2"],
"account_ids": ["facebook-account-id"]
}Caption Rules
| Max length | 5,000 characters for the post's shared caption, or up to 10,000 for a Facebook-only caption in platform_settings.facebook.caption. Longer captions are rejected before the post is saved. |
| Required | No. Text-only posts use the caption as the post body, but media posts can omit it |