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

# Update Ad

> Advanced: partially updates a Spotify ad from a raw field payload including creative assets, call to action, and schedule; only provided fields change

Advanced: partially updates a Spotify ad from a raw field payload including creative assets, call to action, and schedule; only provided fields change. Prefer the dedicated status and rename operations for simple changes.

| | |
| - | - |
| **App** | Spotify Ads |
| **Operation ID** | `spotify_ads_update_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 that owns the ad. |
| `ad_id` | string or SelectItem | Yes | - | Spotify ad ID to update. Do not repeat it inside update\_payload. |
| `update_payload` | object or string | Yes | - | Ad fields to update as a JSON object sent to the Spotify PATCH endpoint as-is; only the fields you include change. Editable fields per the Spotify docs: name (2-200 chars), advertiser\_name (2-25 chars), tagline (2-40 chars), assets (object with asset\_id and logo\_asset\_id, optional companion\_asset\_id and canvas\_asset\_id), start\_time and end\_time (ISO 8601 UTC, nullable), call\_to\_action (object with key, language, clickthrough\_url), third\_party\_tracking (up to 11), dv\_client\_code, catalog (carousel object with 2-6 items), and delivery (ON or OFF; Spotify requires delivery to be the ONLY field in the request, so send it alone or use spotify\_ads\_update\_ad\_status). Prefer the dedicated operations for plain changes: spotify\_ads\_update\_ad\_status, spotify\_ads\_rename\_ad. Example: \{"tagline": "New album out now", "assets": \{"asset\_id": "uuid", "logo\_asset\_id": "uuid"}} |
| `dry_run` | boolean | No | `False` | When true, do not call Spotify. Return the resolved PATCH payload for review. |

### 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 updated fields and the PATCH payload applied.

**Fields**: `ad_id`, `updated_fields`, `endpoint`, `payload`, `dry_run`


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