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