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

> Creates a Spotify audio ad from an audio clip, a logo and a companion image, uploading any file given as a URL

Creates a Spotify audio ad from an audio clip, a logo and a companion image, uploading any file given as a URL. The ad set's creative format must be AUDIO.

| | |
| - | - |
| **App** | Spotify Ads |
| **Operation ID** | `spotify_ads_create_audio_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` | string or array of any | No | - | Up to 11 third party tracking entries, sent as-is. Each item is \{measurement\_partner: IAS\|DCM\|UNSET, url}. |
| `tagline` | string | Yes | - | Short message shown next to the call to action, 2 to 40 characters. |
| `clickthrough_url` | string | No | - | Destination URL the call to action opens. |
| `audio_url` | string | Yes | - | Audio clip for the ad, around 30 seconds, MP3, WAV or OGG. 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). |
| `companion_image_url` | string | Yes | - | Companion image shown while the audio plays, JPEG or PNG, at least 600x500. 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). |

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.