pinterest_get_audiences

Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership.

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

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Optional	Owning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
`mode`	string	Required	Operation or analysis mode. Only the values declared in this schema are supported. One of: `AUDIENCES`, `AUDIENCE`, `CUSTOMER_LISTS`, `CUSTOMER_LIST`, `CUSTOMER_SEGMENTS`, `SHARED_ACCOUNTS`, `BUSINESS_RECEIVED`.
`audienceId`	string	Optional	Exact ID of the audience to inspect or modify.
`customerListId`	string	Optional	Exact customer-list ID. Reading metadata does not upload customer data.
`businessId`	string	Optional	Exact business account ID used for the lookup.
`allowCrossBusinessRead`	boolean	Optional	Explicit opt-in required if the business cannot be linked to the selected ad account. Default: `false`.
`accountType`	string	Optional	Provider account category used to filter results. One of: `AD_ACCOUNT`, `BUSINESS_ACCOUNT`. Default: `"AD_ACCOUNT"`.
`ownershipType`	string	Optional	Filter audiences by provider ownership category. One of: `OWNED`, `RECEIVED`.
`excludeNca`	boolean	Optional	Whether to exclude Pinterest new-customer-acquisition audiences from this lookup.
`pageSize`	integer	Optional	Maximum items requested per page. Follow the returned pagination information for remaining results. Default: `100`.
`bookmark`	string	Optional	Opaque Pinterest pagination bookmark returned by the previous response. Omit on the first request.
`query`	object	Optional	Additional documented query parameters for the selected fixed GET endpoint.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_get_audiences",
    "args": {
      "mode": "AUDIENCES"
    }
  }
}