Skip to content

pinterest_create_collection_ad

Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group.

View as Markdown

Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group. Does not create catalog-only/DPA ads. Standard account eligibility is required; unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

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

Parameters

Parameters
NameTypeRequiredNotes
adAccountIdstringRequiredSelected Pinterest advertiser account. All requests use this account context.
adGroupIdstringRequiredNumeric Pinterest entity ID in the selected advertiser context.
productGroupIdstringRequiredNumeric Pinterest entity ID in the selected advertiser context.
heroPinIdstringRequiredNumeric Pinterest entity ID in the selected advertiser context.
configurationobjectRequiredNative Pinterest v5 request fields. Read pinterest_get_write_schema first. Monetary native fields are integer micro currency units.
confirmbooleanOptionalOnly true applies the displayed change. Omit for a local preview.

Calling it

json · Through run_write_tool, since it is not announced
{
  "name": "run_write_tool",
  "arguments": {
    "name": "pinterest_create_collection_ad",
    "args": {
      "adAccountId": "<string>",
      "adGroupId": "<string>",
      "productGroupId": "<string>",
      "heroPinId": "<string>",
      "configuration": "<object>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

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

Esc

Type to search