# 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…

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Pinterest Ads](https://www.getmcpads.com/docs/sources/pinterest-ads)

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.

> **Warning** This tool changes the account. It is absent from the tool list on the Free plan, and it previews by default: without `confirm: true` it describes the change and applies nothing.

|  |  |
| --- | --- |
| Source | [Pinterest Ads](https://www.getmcpads.com/docs/sources/pinterest-ads) |
| Kind | Write |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/pinterest-ads/mcp |

## 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

Through run_tool, since it is not announced

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

- [Pinterest Ads metrics](https://www.getmcpads.com/docs/sources/pinterest-ads/metrics): What you can ask for.
- [Pinterest Ads dimensions](https://www.getmcpads.com/docs/sources/pinterest-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_create_audience
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.