Inputs
SelectItem
SelectableOption
Output
Type:Dict
Returns ad_id, detected ad_mode, endpoint, updated_fields, final payload, and dry_run status.Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Low-level operation to update tiktok ads, supports both regular and Upgraded Smart+ ads; Markifact checks Smart+ first and resolves the correct endpoint automatically
| App | TikTok Ads |
| Operation ID | tiktok_ads_update_ad |
| Type | Action |
| Connection | tiktok_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
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. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
Dict
Returns ad_id, detected ad_mode, endpoint, updated_fields, final payload, and dry_run status.