Multi-Link Posts (Facebook Carousels)

Create and schedule multi‐link carousel posts on Facebook Pages. Carousels let you showcase up to 10 clickable cards—each with its own image, title, description, and call-to-action—in a single organic post.

Request Body

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "carousel",
            "text": "Explore our top features!",
            "sublinks": [
              {
                "url": "https://publer.com",
                "title": "Publer Dashboard",
                "description": "Manage all your social accounts in one place.",
                "images": [
                  "https://cdn.publer.com/images/dashboard1.jpg",
                  "https://cdn.publer.com/images/dashboard2.jpg"
                ],
                "default_image": 0,
                "call_to_action": "LEARN_MORE"
              },
              {
                "url": "https://publer.com/pricing",
                "title": "Pricing Plans",
                "description": "Find the right plan for your team.",
                "images": [
                  "https://cdn.publer.com/images/pricing.jpg"
                ],
                "default_image": 0,
                "call_to_action": "SIGN_UP"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "63c675b54e299e9cf2b667ea",
            "scheduled_at": "2025-07-06T23:18:00Z"
          }
        ]
      }
    ]
  }
}

Parameters

networks.facebook

Field	Type	Description
type	string	Must be "carousel".
text	string	Caption shown above the carousel cards.
sublinks[]	array	List of carousel items (max 10).

sublinks[] Object

Field	Type	Description
url	string	Target link for this card.
provider_display	string	(Optional) Display domain or provider name.
title	string	Card title (overrides fetched metadata).
description	string	Card description (overrides fetched metadata).
images	string[]	Array of image URLs for this card.
default_image	integer	Index (0-based) of the default image in images.
call_to_action	string	CTA button type: NO_BUTTON, LEARN_MORE, SIGN_UP, etc.
phone_number	string	(Optional) Phone number for call-to-action cards.
customized	boolean	(Optional) true if overriding the link’s default thumbnail or metadata.

Key Notes & Limitations

• Pages Only: Supported on Facebook Pages. Group posts will include only the first sublink.

• Max Sublinks: Up to 10 cards per carousel.

• No Cost: Carousel posts are organic (no ad spend).

• Syncing: Published carousel posts can only sync back as regular link posts (no carousel structure).

Workflow

1. Select Page Choose a Facebook Page account in the accounts array.

2. Define Sublinks Provide url, title, description, and images for each card.

3. Arrange Order Order sublinks as they should appear (array index defines order).

4. Schedule or Publish

   • For scheduled: set scheduled_at under accounts.

   • For immediate: omit scheduled_at and use /posts/schedule/publish.

Best Practices

• Engaging Thumbnails Use high-quality images that clearly represent each link.

• Clear Titles & Descriptions Keep text concise and action-oriented to drive clicks.

• Focused Carousels Limit to 5–7 cards to avoid overwhelming users.

• A/B Test CTAs Experiment with LEARN_MORE, SIGN_UP, and other button types.

Related Topics

• Platform-Specific Formats

• Publishing Methods

• Content Types