Update Ad Group

Low-level operation to update tiktok ad groups, supports both manual and Upgraded Smart+ ad groups; Markifact resolves the correct endpoint automatically

Low-level operation to update tiktok ad groups, supports both manual and Upgraded Smart+ ad groups; Markifact resolves the correct endpoint automatically. Use focused operations first when available, for example tiktok_ads_update_ad_group_budget or tiktok_ads_update_ad_group_status. Use tiktok_ads_list_ad_groups first to inspect the current payload. Use PATCH_FIELDS for partial updates and REPLACE_PAYLOAD for full payload updates.

App	TikTok Ads
Operation ID	tiktok_ads_update_ad_group
Type	Action
Connection	tiktok_ads (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select the TikTok Ads account (advertiser) that owns the ad group.
ad_group_id	string or SelectItem	Yes	-	TikTok ad group ID to update. Markifact uses this value as adgroup_id and does not require adgroup_id inside update_payload.
update_mode	string or SelectableOption	No	PATCH_FIELDS	Use PATCH_FIELDS to update only provided fields. Use REPLACE_PAYLOAD only when providing the full TikTok update payload.
update_payload	object or string	Yes	-	TikTok ad group fields to update as an object or JSON string. Examples: adgroup_name, location_ids, bid_price, targeting_spec. Use tiktok_ads_list_ad_groups first when you need the current payload or exact field names. Exclude advertiser_id and adgroup_id. Note: TikTok can report a successful update but silently keep the old value for fields the ad group’s configuration does not allow changing; for critical settings, verify with tiktok_ads_list_ad_groups after updating.
dry_run	boolean	No	False	When true, do not call TikTok. Return the resolved endpoint, detected ad group mode, and final payload for review.

SelectItem

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.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: Dict

Returns adgroup_id, detected ad_group_mode, endpoint, updated_fields, final payload, and dry_run status.