Feed posts support up to 10 images (no mixed video+image). Stories require single media (24h, no captions). Reels require single vertical video (9:16, 3-60s). Carousel posts (carouselCards) render a 2-5 card multi-link post, images only, mutually exclusive with story/reel. Geo-restriction is a hard visibility restriction: users outside the specified countries cannot see the post. Not supported for stories.
| Name | Type | Description | Notes |
|---|---|---|---|
| draft | Boolean | When true, creates the post as a draft in Facebook Publishing Tools instead of publishing immediately. Supported for feed posts (text, link, image, video) and reels. Not supported for stories. Drafts expire after ~30 days. | [optional] |
| contentType | ContentTypeEnum | Set to 'story' for Page Stories (24h ephemeral) or 'reel' for Reels (short vertical video). Defaults to feed post if omitted. | [optional] |
| title | String | Reel title (only for contentType=reel). Separate from the caption/content field. | [optional] |
| firstComment | String | Optional first comment to post immediately after publishing (feed posts and reels, not stories). Skipped when draft is true. | [optional] |
| pageId | String | Target Facebook Page ID for multi-page posting. If omitted, uses the default page. Use GET /v1/accounts/{id}/facebook-page to list pages. | [optional] |
| geoRestriction | GeoRestriction | [optional] | |
| carouselCards | List<FacebookPlatformDataCarouselCardsInner> | Renders the post as a multi-link carousel (organic Page post). When set, mediaItems must be provided with the same length and all items must be images (no videos). Each cards[i] adds the click-through link and headline for the image at mediaItems[i]. Mutually exclusive with contentType=story | reel. Facebook display truncates name at ~35 chars and description at ~30 chars; longer strings are accepted but get truncated on render. |
| carouselLink | URI | Optional top-level "See more" destination shown on the carousel end card. Defaults to the first card's link when omitted. Only used together with carouselCards. | [optional] |
| Name | Value |
|---|---|
| STORY | "story" |
| REEL | "reel" |