> ## Documentation Index > Fetch the complete documentation index at: https://docs.markifact.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Carousel Ad > Creates new Meta carousel ads with 2-10 cards containing images or videos (bulk mode only) Creates new Meta carousel ads with 2-10 cards containing images or videos (bulk mode only). By default it creates the full ad. It can also run in creative-only mode, which returns a creative\_id without attaching it to an ad; that creative\_id can then be used with meta\_ads\_replace\_ad\_creative. It also supports detailed-results mode: by default the response returns only IDs, while return\_detailed\_results=true returns per-row success and failure details. Detailed results are recommended for AI agents. | | | | --------------------- | ----------------------------- | | **App** | Meta Ads | | **Operation ID** | `meta_ads_create_carousel_ad` | | **Type** | Action | | **Connection** | `meta_ads` (required) | | **Credits per run** | 3 | | **Agent / MCP tool** | Yes | | **Requires approval** | Yes (write operation) | ## Inputs | Field | Type | Required | Default | Description | | ------------------------- | --------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account` | DynamicAccount | Yes | - | Select the Meta Ads account, ask the user for it if not provided | | `page` | string or SelectItem | Yes | - | Select Facebook page, ask the user for it if not provided | | `instagram_user_id` | string or SelectItem | No | - | Optional Instagram account override. Leave empty in nearly all cases — the Instagram account linked to the selected Page is used automatically. Only set this when the user wants to advertise with a different Instagram account they have access to. Value is the numeric IG user/business account id. | | `structured_data` | array (also accepts a comma-separated string) | Yes | - | Structured data containing carousel ad information. Each row represents one carousel ad with multiple cards (2-10 cards per ad). Required columns: adset\_id, ad\_name, ad\_status, primary\_text, website\_url, card\_1\_media\_url, card\_1\_headline, card\_2\_media\_url, card\_2\_headline. Optional columns: card\_N\_description, card\_N\_website\_url, card\_N\_call\_to\_action, card\_N\_story\_media\_url (for placement optimization), form\_id (for lead form ads), disable\_creative\_enhancements (set to True to disable Meta's automatic creative optimizations), disable\_multi\_advertiser\_ads (set to True to opt out of showing your ad alongside other ads), pixel\_id (optional, leave empty to inherit from adset and account), ad\_start\_time (schedule ad start, format: YYYY-MM-DD HH:MM or YYYY-MM-DD, in the ad account's timezone), ad\_end\_time (schedule ad end, format: YYYY-MM-DD HH:MM or YYYY-MM-DD, in the ad account's timezone). IMPORTANT: For additional cards (3-10), if ANY field is provided for a card, then both card\_N\_media\_url AND card\_N\_headline become required. No incomplete card data allowed. Video thumbnails are auto-generated. Note: user can provide direct media URLs or Google Drive share links; Markifact will convert Drive links to direct URLs automatically, the only requirement is that the file sharing is set to 'Anyone with the link'. | | `creative_only` | boolean | No | `False` | Set to true to create only the Meta ad creative without creating an ad. Useful when editing an existing ad: create a new creative with the updated carousel cards, media, text, or URLs, then attach it using replace\_ad\_creative. When true, adset\_id is not required since you're not creating a new ad, just an ad creative. Returns creative IDs instead of ad IDs. Default is false. | | `return_detailed_results` | boolean | No | `False` | If true, returns per-row results (success\_count, failed\_count, total\_count, results\[]) and does NOT raise an error on partial failures so the workflow can continue. If false (default), returns a simple summary and raises an error if any row fails. | ### SelectItem | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- | | `value` | string | Yes | - | The value of the selectable item. | | `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. | ## Output **Type**: `Dict` Returns created ad details, a list of ad IDs and count. **Fields**: `ad_ids`, `created_count`