meta_ads_creatives_create_carousel
Create a carousel ad with 2–10 swipeable cards, each with its own image, name, description, and link. Returns the new creative ID.
Instructions
Creates a Carousel AdCreative with 2–10 swipeable cards. Returns the new creative id. Mutating — not automatically reversible; record before-state with mureo_state_action_log_append if you may need to roll back. Each card carries its own image (or video), name, description, and link — useful for product catalogs or multi-step narratives. For auto-optimized asset rotation use meta_ads_creatives_create_dynamic; for product-feed-driven carousels use meta_ads_creatives_create_collection.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | Yes | Main destination URL — used for the See More card and as fallback when a card has no explicit link. | |
| name | No | Creative name shown in Ads Manager. Optional. | |
| cards | Yes | Carousel cards (2–10). Each card must have a link; image_hash, image_url, or video_id is required for the media. | |
| page_id | Yes | Facebook Page ID that the ad will be published as. Must be a page the authenticated user has permission to post from. Required by Meta for every creative — ads cannot run without a page identity. | |
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. |