> ## 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 a Spotify carousel ad that listeners swipe through, from a logo and 2 to 6 cards, each with its own image, tagline, destination URL and optional price

Creates a Spotify carousel ad that listeners swipe through, from a logo and 2 to 6 cards, each with its own image, tagline, destination URL and optional price. Uploads any file given as a URL. The ad set's creative format must be CATALOG.

|                       |                                  |
| --------------------- | -------------------------------- |
| **App**               | Spotify Ads                      |
| **Operation ID**      | `spotify_ads_create_carousel_ad` |
| **Type**              | Action                           |
| **Connection**        | `spotify_ads` (required)         |
| **Credits per run**   | 1                                |
| **Agent / MCP tool**  | Yes                              |
| **Requires approval** | Yes (write operation)            |

## Inputs

| Field                     | Type                                                                                                                | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`                 | DynamicAccount                                                                                                      | Yes      | -       | Select the Spotify Ads account to create the ad in.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ad_set_id`               | string or SelectItem                                                                                                | Yes      | -       | Ad set the ad belongs to. Its creative format must match this operation, and it is checked before the ad is created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `name`                    | string                                                                                                              | Yes      | -       | Ad name, 2 to 200 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `advertiser_name`         | string                                                                                                              | Yes      | -       | Advertiser name shown with the ad, 2 to 25 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `logo_url`                | string                                                                                                              | Yes      | -       | Square logo image, JPEG or PNG, at least 600x600. Accepts a direct URL, a Google Drive share link (set to 'Anyone with the link'), a Markifact uploaded file, or the id of an asset already in the account (from spotify\_ads\_list\_assets or spotify\_ads\_upload\_media).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `call_to_action_key`      | enum (`APPLY_NOW`, `BOOK_NOW`, `BUY_NOW`, `BUY_TICKETS`, `CLICK_NOW`, `DOWNLOAD`, `FIND_STORES`, `GET_COUPON`, ...) | No       | -       | Button text on the call to action card, for example LEARN\_MORE, LISTEN\_NOW, SHOP\_NOW. Spotify defaults to LEARN\_MORE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `call_to_action_language` | enum (`ARABIC`, `ARABIC_EGYPT`, `BULGARIAN`, `CHINESE`, `CHINESE_HK`, `CHINESE_TAIWAN`, `CROATIAN`, `CZECH`, ...)   | No       | -       | Language the button text is shown in. Spotify defaults to ENGLISH.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `start_time`              | string                                                                                                              | No       | -       | When the ad starts, ISO 8601 UTC. Inherits the ad set schedule when omitted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `end_time`                | string                                                                                                              | No       | -       | When the ad stops, ISO 8601 UTC.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `delivery`                | enum (`ON`, `OFF`)                                                                                                  | No       | -       | Whether the ad starts delivering (ON) or paused (OFF).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `dv_client_code`          | string                                                                                                              | No       | -       | DoubleVerify client code for third party verification.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `third_party_tracking`    | array of any or string                                                                                              | No       | -       | Up to 11 third party tracking entries, sent as-is. Each item is \{measurement\_partner: IAS\|DCM\|UNSET, url}.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `cards`                   | array of object or string                                                                                           | Yes      | -       | JSON list of 2 to 6 carousel cards, shown in the order given. Each card takes image\_url (required; square JPEG or PNG, at least 600x600, or the id of an existing asset), tagline (required, 2 to 40 characters) and clickthrough\_url (required), plus optional sku, price, sale\_price (amounts in the ad account's currency) and currency\_code. The first card's tagline and clickthrough URL also become the ad's own, matching how Spotify's Ads Manager builds carousel ads. Example: \[\{"image\_url": "`https://example.com/a.jpg`", "tagline": "Artisan bowl", "clickthrough\_url": "`https://example.com/a`", "price": 20}, \{"image\_url": "`https://example.com/b.jpg`", "tagline": "Ceramic mug", "clickthrough\_url": "`https://example.com/b`"}] |

### 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 the created ad including id, ad\_set\_id, name, status, assets, call\_to\_action, catalog with its items, and ad\_preview\_url.

**Fields**: dynamic (depend on the inputs)