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} |