Update Ad

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

Get Started

Guides

Operations

Inputs

SelectItem

Output

​Inputs

​SelectItem

​Output

Inputs

SelectItem

Output