Skip to main content
DMs use Meta’s 24-hour messaging window. Comments support full fetch / reply / hide / delete. Reels and Stories are selected with platform_options.facebook.type (reel / story); omit it for a feed post. A story carries no caption - Meta’s Page Stories API has no text parameter - and lives for 24 hours. See Platform options for the per-type media rules.

Reel limit

Facebook allows 30 API-published Reels per Page in a moving 24-hour window. Creating or scheduling a Reel is refused up front when the Page would be at the limit at the post’s publish time (Reels published plus Reels already scheduled in the 24 hours before it): 422 PLATFORM_DAILY_LIMIT_REACHED, with details.next_available_at saying when a Reel fits again. Check the allowance with Get Facebook Reel limit. Reels posted to the Page outside this platform are not counted, so Facebook can still refuse a Reel; a scheduled Reel that hits the limit when it publishes fails with the same error code and is not retried automatically.

Page settings

These calls manage the Facebook Page behind a connected account, where account_id is the connected account’s id. A test key (sqk_test_...) validates the request - including checking the image URL - and returns a success response without contacting Facebook.

Message button

PATCH /v1/social/accounts/{account_id}/facebook/page/settings with {"users_can_message": false} turns messaging off: the Page’s Message button is hidden and replies are blocked in chats that already exist. Send true to restore both. Read the current value with GET /v1/social/accounts/{account_id}/facebook/page/settings; users_can_message is null when Facebook did not report the setting.

Profile picture

POST /v1/social/accounts/{account_id}/facebook/page/picture with {"url": "https://..."}. Facebook downloads the image from that URL itself. No feed story is created and followers are not notified. Facebook shows the picture as a circle, so a square image of 196 x 196 px or larger works best.

Cover photo

POST /v1/social/accounts/{account_id}/facebook/page/cover with url and an optional offset_y (0-100, default 50). No feed story is created and followers are not notified. The recommended size is 851 x 315 px. This call needs the business permission on the connection. A connection without it gets 403 CONNECTION_SCOPE_MISSING with reconnect_required: true - reconnect the account to fix it. A cover photo can be replaced through the API but not removed; removing it has to be done on Facebook.

Image rules

Only the format, file size and cover minimum are enforced. An image that breaks one is refused with 422 VALIDATION_ERROR, with details.field set to "url" and details.reason one of invalid_url, unreachable, too_large, unsupported_type or, for a cover photo only, too_small. API reference: Get page settings | Update page settings | Set profile picture | Set cover photo See all platforms for the capability matrix and media rules.