Update Ad

Fallback Meta Ads ad patch tool for advanced or unsupported cases at the ad level, such as renaming an ad, changing ad_schedule_start_time/ad_schedule_end_time (only on ads created with a schedule;…

Fallback Meta Ads ad patch tool for advanced or unsupported cases at the ad level, such as renaming an ad, changing ad_schedule_start_time/ad_schedule_end_time (only on ads created with a schedule; sales and app promotion campaigns), tracking_specs, conversion_domain, or adlabels. This does NOT edit the ad’s creative content: Meta creatives are immutable, so to change text, image, video, or link, 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. Patches only the fields provided in update_payload. Supports dry-run review before applying changes.

App	Meta Ads
Operation ID	meta_ads_update_ad
Type	Action
Connection	meta_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 Meta Ads account, ask the user for it if not provided
ad_id	string or SelectItem	Yes	-	The Meta Ads ad ID to update. Do not include this inside update_payload.
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).
dry_run	boolean	No	False	When true, return the resolved update payload without calling Meta Ads.

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.

Output

Type: Dict

Returns ad_id, ad_name, updated_fields, final payload, dry_run status, and any returned Meta response data.

Fields: dynamic (depend on the inputs)