account | DynamicAccount | Yes | - | Select the TikTok Ads account (advertiser) that owns the ad. |
ad_id | string or SelectItem | Yes | - | TikTok ad ID to update. |
update_mode | string or SelectableOption | No | PATCH_FIELDS | Use PATCH_FIELDS for incremental updates. For manual ads, TikTok only supports patching ad_name, identity, media, music, TikTok item, and ad text fields. Use REPLACE_PAYLOAD for full manual ad creative updates or full Smart+ payload updates. |
update_payload | object or string | Yes | - | TikTok ad fields to update as an object or JSON string. Examples: ad_name, ad_text, ad_texts, video_id, image_ids, creative_list. Use tiktok_ads_list_ads first when you need the current payload or exact field names. Exclude advertiser_id, ad_id, smart_plus_ad_id, and adgroup_id. |
dry_run | boolean | No | False | When true, do not call TikTok. Return the resolved endpoint, detected ad mode, and final payload for review. |