Update Audience - Markifact

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