> ## 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 Ad

> Advanced: creates a Spotify ad from already-uploaded asset ids, for cases the per-format operations do not cover

Advanced: creates a Spotify ad from already-uploaded asset ids, for cases the per-format operations do not cover. Prefer spotify\_ads\_create\_audio\_ad, spotify\_ads\_create\_video\_ad, spotify\_ads\_create\_display\_ad or spotify\_ads\_create\_carousel\_ad, which accept media URLs directly.

|                       |                          |
| --------------------- | ------------------------ |
| **App**               | Spotify Ads              |
| **Operation ID**      | `spotify_ads_create_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. The ad set's asset\_format decides which creative this ad needs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `name`                    | string                                                                                                              | Yes      | -       | Ad name, 2 to 200 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `advertiser_name`         | string                                                                                                              | Yes      | -       | Advertiser name shown with the ad, 2 to 25 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `tagline`                 | string                                                                                                              | Yes      | -       | Tagline shown on the call to action card, 2 to 40 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `asset_id`                | string or SelectItem                                                                                                | Yes      | -       | Main creative asset (audio, video or image) matching the ad set's asset\_format. Upload with spotify\_ads\_upload\_media or pick an existing asset from spotify\_ads\_list\_assets.                                                                                                                                                                                                                                                                                                                                                                                                        |
| `logo_asset_id`           | string or SelectItem                                                                                                | Yes      | -       | Image asset used as the logo on the call to action card.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `companion_asset_id`      | string or SelectItem                                                                                                | No       | -       | Optional companion image asset shown alongside audio ads.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `canvas_asset_id`         | string or SelectItem                                                                                                | No       | -       | Optional vertical 9:16 video or image asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `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, PRE\_SAVE. 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `clickthrough_url`        | string                                                                                                              | No       | -       | Landing page the call to action opens.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `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}. Example: \[\{"measurement\_partner": "IAS", "url": "`https://tracker.example.com`"}]                                                                                                                                                                                                                                                                                                                                                                                        |
| `catalog`                 | object or string                                                                                                    | No       | -       | Catalog of things to be placed in a carousel type ad, sent as-is. Only for ad sets whose asset\_format is CATALOG. Shape: \{name, catalog\_items: \[...]} with 2 to 6 items. Each item takes asset\_id and clickthrough\_url (both required), tagline (2 to 40 characters, required), and optional sku, position, price and sale\_price objects of \{micro\_amount, currency\_code}. Example: \{"catalog\_items": \[\{"asset\_id": "uuid", "clickthrough\_url": "`https://example.com/item`", "tagline": "Artisan bowl", "price": \{"micro\_amount": 20000000, "currency\_code": "USD"}}]} |

### 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 and ad\_preview\_url.

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