Update Audience

Updates a Pinterest Ads audience’s name, description, or rule, or removes the users matched by a rule from it (operation_type REMOVE)

Updates a Pinterest Ads audience’s name, description, or rule, or removes the users matched by a rule from it (operation_type REMOVE). Audience IDs come from pinterest_ads_list_audiences.

App	Pinterest Ads
Operation ID	pinterest_ads_update_audience
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 audience.
audience_id	string or SelectItem	Yes	-	Pinterest audience ID to update. Find IDs with pinterest_ads_list_audiences.
operation_type	string or SelectableOption	No	{'value': 'UPDATE', 'label': 'Update'}	UPDATE (default) applies the provided name, description, or rule changes. REMOVE removes the users matched by rule from the audience, for example a customer list.
audience_name	string	No	-	Optional new name for the audience.
description	string	No	-	Optional new audience description.
rule	object or string	No	-	Optional JSON rule object, sent to Pinterest as-is. Same shapes as pinterest_ads_create_audience (customer_list_id, visitor_source_id, engagement_domain, or seed_id based rules). Required when operation_type is REMOVE.

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 the updated audience ID, operation, and changed fields.

Fields: audience_id, operation_type, updated_fields, status