pinterest_create_audience

Create a Pinterest audience in the selected account: CUSTOMER_LIST from a customer list, VISITOR from the account's Pinterest Tag events, ENGAGEMENT…

View as Markdown

Create a Pinterest audience in the selected account: CUSTOMER_LIST from a customer list, VISITOR from the account's Pinterest Tag events, ENGAGEMENT from people who engaged with its Pins, or ACTALIKE from seed audiences. Pinterest builds it within 48 to 72 hours and targets it once READY (100 people at least). Include it in targeting_spec.AUDIENCE_INCLUDE or exclude it in AUDIENCE_EXCLUDE of an ad group. Preview by default. No automatic mutation retry.

Source: Pinterest Ads
Kind: Write
Discovery: Reachable through search_tools and run_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/pinterest-ads/mcp

Parameters

Parameters
Name	Type	Required	Notes
`adAccountId`	string	Required	Selected Pinterest advertiser account that will own it.
`name`	string	Required	Exact name.
`audienceType`	string	Required	Native audience_type. PERSONA audiences are made by Pinterest only. One of: `CUSTOMER_LIST`, `VISITOR`, `ENGAGEMENT`, `ACTALIKE`.
`rule`	object	Required	Native rule. CUSTOMER_LIST {"customer_list_id"}; VISITOR {"visitor_source_id":["<tag ID>"],"retention_days":180,"event":"pagevisit"}; ENGAGEMENT {"engagement_domain":["example.com"],"engager_type":1} or {"engagement_type":"click"}; ACTALIKE {"seed_id":["<audience ID>"],"country":"FR","percentage":5}.
`description`	string	Optional	Optional audience description.
`confirm`	boolean	Optional	Only true applies the displayed change. Omit for a local preview.

Calling it

json · Through run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_create_audience",
    "args": {
      "adAccountId": "<string>",
      "name": "<string>",
      "audienceType": "CUSTOMER_LIST",
      "rule": "<object>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.