update_payload | object or string | Yes | - | Ad fields to update as a JSON object; only the fields you include are changed (each key becomes a JSON-Patch add operation, and a null value removes an optional attribute). Editable fields per the Snapchat docs: name, status (ACTIVE/PAUSED), start_time, end_time (ISO 8601), third_party_paid_impression_tracking_urls, and third_party_on_swipe_tracking_urls (lists of https URLs from approved domains). creative_id is NOT editable on an ad: to change the creative content (headline, CTA, attachment URL), use snapchat_ads_update_creative on the ad’s creative, which affects all ads using it and triggers re-review; to show entirely different content, create a new creative and a new ad instead. Prefer the dedicated operations for plain changes: snapchat_ads_update_ad_status and snapchat_ads_rename_ad. Example: {“end_time”: “2026-09-30T00:00:00Z”} |