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

> Advanced: partially updates a Spotify ad set from a raw field payload including budget, bid, targeting, and schedule; only provided fields change and micro-currency fields are raw integers

Advanced: partially updates a Spotify ad set from a raw field payload including budget, bid, targeting, and schedule; only provided fields change and micro-currency fields are raw integers. Prefer the dedicated status, rename, and budget operations for simple changes.

|                       |                             |
| --------------------- | --------------------------- |
| **App**               | Spotify Ads                 |
| **Operation ID**      | `spotify_ads_update_ad_set` |
| **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 set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ad_set_id`      | string or SelectItem | Yes      | -       | Spotify ad set ID to update. Do not repeat it inside update\_payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `update_payload` | object or string     | Yes      | -       | Ad set 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, start\_time and end\_time (ISO 8601 UTC), budget (object with micro\_amount, a raw micro-currency integer, and type DAILY or LIFETIME), bid\_micro\_amount, base\_rate\_micro\_amount, cost\_modifiers, pacing (PACING\_EVEN or PACING\_ASAP), frequency\_caps (up to 6), targets (the full Spotify targeting object), category, dataset\_id, video\_delivery\_formats, slot\_positions, 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\_set\_status). Prefer the dedicated operations for plain changes: spotify\_ads\_update\_ad\_set\_status, spotify\_ads\_rename\_ad\_set, spotify\_ads\_update\_ad\_set\_budget. Example: \{"end\_time": "2026-09-30T00:00:00Z", "bid\_micro\_amount": 5000000} |
| `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_set_id`, `updated_fields`, `endpoint`, `payload`, `dry_run`