Facebook supports the widest range of post types in the Swonkie API, including carousels with per-card call-to-action buttons.
Supported Post Types#
| Post Type | Description |
|---|
MEDIA | One or more images or videos |
STATUS | Text-only post, no media |
STORY | Full-screen image or video story |
LINK | URL post with optional preview image |
REEL | Short-form vertical video |
Network Options#
Facebook-specific settings are passed in the facebook object on the post body.| Field | Type | Description |
|---|
carousels | array | List of carousel cards (minimum 2). Only valid on MEDIA posts. |
carouselEndCard | boolean | When true, appends your page profile logo as a final card |
Carousel card fields#
| Field | Type | Required | Description |
|---|
link | string (URI) | Yes | Destination URL, max 2000 characters |
title | string | Yes | Card title, max 200 characters |
description | string | No | Card description, max 1000 characters |
mediaLibId | string | No | Media ID from POST /v2/media |
callToAction | string (enum) | No | Button label displayed on the card |
callToAction values#
NO_BUTTON, BOOK_TRAVEL, BUY_NOW, DOWNLOAD, GET_QUOTE, INSTALL_APP, INSTALL_MOBILE_APP, LEARN_MORE, LIKE_PAGE, LISTEN_MUSIC, OPEN_LINK, PLAY_GAME, SHOP_NOW, SIGN_UP, SUBSCRIBE, USE_APP, USE_MOBILE_APP, WATCH_MORE, WATCH_VIDEO, MESSAGE_PAGE
Examples#
MEDIA post#
Carousel post#
LINK post#
Notes#
Carousel posts require a minimum of 2 cards in the carousels array.
Captions are not supported on STORY posts.
MEDIA and LINK posts do not share their respective arrays: medias is ignored on LINK posts and links is ignored on MEDIA posts.
The net field on captions, media, and links can be omitted to apply the content to all networks assigned to the post.
Modified at 2026-03-12 18:21:59
