Create Audience

Creates a Pinterest Ads audience: customer list, site visitor, engagement, or actalike (lookalike)

Creates a Pinterest Ads audience: customer list, site visitor, engagement, or actalike (lookalike). The rule object defines who is targeted and its shape depends on the audience type. Use pinterest_ads_list_audiences to find seed audience IDs for actalikes.

App	Pinterest Ads
Operation ID	pinterest_ads_create_audience
Type	Action
Connection	pinterest_ads (required)
Credits per run	2
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select Pinterest Ads account to create the audience in.
audience_name	string	Yes	-	Name of the Pinterest audience.
audience_type	string or SelectableOption	Yes	-	Audience type. CUSTOMER_LIST targets an uploaded customer list, VISITOR targets site visitors from a conversion tag, ENGAGEMENT targets people who engaged with the account’s Pins, ACTALIKE builds a lookalike from a seed audience.
description	string	No	-	Optional audience description.
rule	object or string	Yes	-	JSON object defining the audience, sent to Pinterest as-is. Shape depends on audience_type: - CUSTOMER_LIST: {“customer_list_id”: “<customer list ID>”} - VISITOR: {“visitor_source_id”: [“<conversion tag ID>”], “retention_days”: “180”, “event_source”: {”=”: [“web”, “mobile”]}, “ingestion_source”: {”=”: [“tag”]}} (retention_days 1-540; optional event key for a specific tag event such as checkout or signup) - ENGAGEMENT: {“engagement_domain”: [“www.example.com”], “engager_type”: 1} (optional engagement_type: click, save, closeup, comment, or like; optional ad_id or campaign_id arrays to scope the engagement) - ACTALIKE: {“seed_id”: [“<audience ID>”], “country”: “US”, “percentage”: “10”} (countries US, CA, or GB; percentage 1-10; find seed audience IDs with pinterest_ads_list_audiences)

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: Dict

Returns the created Pinterest audience details.

Fields: audience_id, audience_name, audience_type, status