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