Update Ad

Low-level operation to update Pinterest Ads ads with a raw PATCH payload; only the provided fields are changed

Low-level operation to update Pinterest Ads ads with a raw PATCH payload; only the provided fields are changed. Use focused operations first when available, for example pinterest_ads_update_ad_status or pinterest_ads_rename_ad. Use pinterest_ads_list_ads first to inspect the current payload. Supports dry_run to preview the final payload without calling Pinterest.

App	Pinterest Ads
Operation ID	pinterest_ads_update_ad
Type	Action
Connection	pinterest_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 Pinterest Ads account that owns the ad.
ad_id	string or SelectItem	Yes	-	Pinterest ad ID to update. Markifact sends it as id; do not repeat it inside update_payload.
update_payload	object or string	Yes	-	Ad fields to update as a JSON object, sent to Pinterest as-is in a PATCH request; only the fields you include are changed. Common fields: name, status (ACTIVE/PAUSED/ARCHIVED), destination_url, customizable_cta_type, is_dynamic_cta (bool) with cta_types (at least two from ADD_TO_CART, BUY_NOW, CONTACT_US, EXPLORE_MORE, GET_OFFER, LEARN_MORE, ORDER_NOW, SHOP_NOW, TAKE_A_PEEK, VISIT_SITE, including the objective’s default such as VISIT_SITE for CONSIDERATION) as an alternative to a fixed customizable_cta_type, click_tracking_url, view_tracking_url, android_deep_link, ios_deep_link, carousel_destination_urls / carousel_android_deep_links / carousel_ios_deep_links (arrays, one entry per card), lead_form_id, grid_click_type, is_removable. Prefer pinterest_ads_update_ad_status and pinterest_ads_rename_ad for plain status or name changes. Example: {“destination_url”: “https://example.com/sale”, “customizable_cta_type”: “SHOP_NOW”}
dry_run	boolean	No	False	When true, do not call Pinterest. Return the resolved endpoint 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.

Output

Type: Dict

Returns ad_id, updated_fields, endpoint, final payload, and dry_run status.

Fields: ad_id, updated_fields, endpoint, payload, dry_run