update_payload | object or string | Yes | - | Patch payload for Meta’s Ad update API as an object or JSON string. Only the fields provided here are sent to Meta; this does not replace the full ad. Updatable ad-level fields include: name, ad_schedule_start_time / ad_schedule_end_time (ISO 8601 with UTC offset; only changeable on ads created with a schedule, sales and app promotion campaigns only), tracking_specs, conversion_domain, adlabels. This does NOT edit the ad’s creative content (text, image, video, link): Meta creatives are immutable, so to change content create a new creative (meta_ads_create_ad_creative or a create node with creative_only=true) and attach it with meta_ads_replace_ad_creative. Use meta_ads_update_ad_status for status changes. Do not include identity fields like account_id, ad_id, or adset_id (ads cannot be moved between ad sets). |