# Pinterest Ads MCP > Pinterest Ads gives your AI agent direct access to manage all aspects of Pinterest advertising campaigns without ever opening the web dashboard. You can list and create entire campaign structures, pull detailed analytics (impressions, ROAS, clicks) from specific ad groups or accounts, pause underperforming ads instantly, and monitor product catalog health for shopping ads—all via conversation. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** ad-campaign-management, performance-tracking, shopping-ads, audience-insights, conversion-tracking, marketing-automation ## Description Your AI agent gives you direct access to Pinterest Ads so you never gotta open that clunky web dashboard. You can handle your whole ad spend—from setting up a campaign structure to pulling performance data—all through conversation. It’s like having an ad specialist sitting right next to you, who pulls complex analytics in seconds. ### Campaign Management and Control **`list_campaigns`** gives you the full rundown of every running campaign and its current status so you know exactly what's live. You can then use **`enable_campaign`** to reactivate a campaign that got paused, or run **`pause_campaign`** to immediately kill spending on an entire campaign or ad group if it ain’t working. If you wanna check the structure before making changes, **`list_adgroups`** pulls up every existing ad group in your account. ### Pulling Granular Performance Metrics You don't just want a summary; you need numbers separated by where they came from. You get overall performance metrics—like total ROAS, clicks, and spend for the whole thing—using **`get_account_analytics`**. For a deeper dive into a specific campaign, **`get_campaign_analytics`** pulls core metrics like impressions, conversions, and clicks across that entire defined campaign. If you want to drill down even further, checking performance by an individual ad group is easy with **`get_adgroup_analytics`**, giving you the stats for just that segment. ### Identifying Top-Performing Ads and Groups **`list_ads`** pulls a complete directory of every single Pin running in your campaigns. You check this list to see which creative is actually driving traffic or if any ads need tweaking. While **`get_adgroup_analytics`** lets you analyze performance by ad group, the agent also handles querying audience data and catalog health for shopping ads so you know who you're talking to and that your products sync up right. ### Workflow Summary Your agent uses these tools together. You ask it for the ROAS on a specific collection's pins, and it runs **`list_ads`** first, then uses **`get_adgroup_analytics`** to pull the exact numbers you need—all without you having to click anything. ## Tools ### enable_campaign Activates a campaign that was previously paused or disabled in your account. ### get_account_analytics Retrieves overall performance metrics (ROAS, clicks, spend) for the entire Pinterest ad account. ### get_adgroup_analytics Fetches detailed analytics and performance stats for a specific ad group within a campaign. ### get_campaign_analytics Retrieves core metrics like impressions, clicks, and conversions for an entire defined campaign. ### list_adgroups Generates a list of all existing ad groups within the account that you can then analyze or modify. ### list_ads Pulls a directory listing of every individual ad (Pin) currently running in your campaigns. ### list_campaigns Provides a comprehensive list of all campaign names and current statuses available to the agent. ### pause_campaign Deactivates an entire campaign or ad group, stopping spending immediately to save budget. ## Prompt Examples **Prompt:** ``` How are my Pinterest shopping campaigns performing? ``` **Response:** ``` 3 active shopping campaigns. Total spend this week: $2,100. Best performer: 'Spring Collection' (ROAS: 5.2x, 890 clicks, 67 checkouts). Catalog: 2,340 products synced, 98% approved. ``` **Prompt:** ``` Which pins have the highest engagement rate? ``` **Response:** ``` Top 3 pins by engagement: 1) 'Minimalist Kitchen Ideas' (12.5% engagement, 4,200 saves), 2) 'Fall Wardrobe Essentials' (10.8%, 3,100 saves), 3) 'Home Office Setup Guide' (9.2%, 2,800 saves). ``` **Prompt:** ``` Increase the budget on 'Spring Collection' campaign by 20%. ``` **Response:** ``` Budget updated: 'Spring Collection' daily budget changed from $300 to $360 (+20%). Based on current performance (5.2x ROAS), the additional $60/day should generate approximately 19 more checkouts. ``` ## Capabilities ### View and Control Campaigns List all running campaigns or enable/pause specific ad groups and entire campaigns with simple commands. ### Pull Granular Performance Metrics Get detailed analytics—including clicks, conversions, ROAS, and impressions—separated by the whole account, campaign level, or individual ad group. ### Manage Product Catalogs Monitor product catalog sync status and track performance metrics specifically for your shopping ads. ### Identify Best-Performing Pins List individual ads (Pins) to check their specific engagement rates or view which creatives are driving the most traffic. ### Analyze Audience Data Query data on audience demographics and interests to refine your targeting parameters. ## Use Cases ### The Weekend Review A brand owner needs a quick performance snapshot for their weekend report. Instead of logging into Pinterest Ads Manager, they ask their agent: 'What were my top 3 performing ads this week?' The agent runs `list_ads` and then uses `get_adgroup_analytics` to pull the key metrics for those specific Pins, delivering a ready-to-use bulleted list. ### The Budget Crisis A campaign is spending money but generating zero conversions. The analyst realizes they need to cut losses immediately. They ask their agent: 'Pause the ad group for Fall Footwear.' The agent runs `pause_adgroup` instantly, stopping all unnecessary spend and saving budget. ### The Expansion Project A marketing team launches a new product line and needs to test it. They use the agent to run `list_campaigns` to see available slots, then ask for help setting up the structure, running `enable_campaign`, and monitoring early performance with `get_campaign_analytics`. ### The Technical Audit An e-commerce developer needs to confirm product catalog health. They use the agent's built-in shopping ad tools to check the sync status, ensuring that all 2000+ products are correctly listed and approved for advertising. ## Benefits - **Deep Dive Analytics:** Instead of viewing a summary, your agent runs `get_adgroup_analytics` to pull the exact ROAS, CPC, and click counts for any specific ad group. You don't guess; you get hard numbers immediately. - **Instant Budget Control:** Stop spending money on poor performers. Use `pause_campaign` or `pause_adgroup` to shut down campaigns that are burning budget without returning conversions. It’s an instant stop-gap measure. - **Full Account Visibility:** Get the bird's eye view with `get_account_analytics`. This tool aggregates metrics across all your active ads and groups, letting you see overall trends without clicking through multiple dashboards. - **Campaign Structure Control:** Need to expand or scale? Use `list_campaigns` to map out your current structure, then use `enable_campaign` when it's time to fire up a dormant, high-potential campaign. - **Pin Performance Audit:** Run `list_ads` to see every single Pin currently running. This lets you quickly identify which creative assets are getting the highest engagement rates across the board. ## How It Works The bottom line is: You talk to your agent in plain English, and it handles all the API calls needed behind the scenes. 1. First, subscribe to the Pinterest Ads integration on Vinkius. This grants your agent permission to talk to the platform. 2. Next, set up the necessary credentials in the Pinterest Developer Portal and link them securely to your account. 3. Finally, you ask your agent a question (e.g., 'How did Campaign X do last week?'). The agent runs the required tool (`get_campaign_analytics`) and delivers the answer. ## Frequently Asked Questions **How do I get my Pinterest Ads API credentials?** 1. Go to **developers.pinterest.com** and log in with your Pinterest Business account. 2. Click **My Apps** → **Create App**. 3. Fill in the app name and description. 4. After creation, copy your **App ID** and **App Secret** from the app dashboard. 5. Generate an **Access Token** by authorizing your ad account. 6. Paste all values below. 💡 You need a **Pinterest Business Account** with an active ads account. Convert a personal account at [business.pinterest.com](https://business.pinterest.com). **Can I track shopping ad performance?** Yes. Your AI agent tracks product-level metrics including impressions, clicks, add-to-carts, checkouts, ROAS, and catalog sync health — giving you real-time visibility into your Pinterest shopping campaigns. **What audience targeting is available?** Pinterest supports interest targeting, keyword targeting, demographics (age, gender, location), device targeting, customer lists, website visitors (retargeting), actalike audiences, and shopping behavior targeting. **Is this useful for e-commerce brands?** Absolutely. Pinterest is one of the highest-intent social platforms for shopping — 80% of weekly users have discovered a new brand or product on Pinterest. Your AI agent helps you maximize ROAS across product catalog campaigns. **How do I use the `pause_campaign` tool with Pinterest Ads?** You just tell your agent which campaign to pause. It executes the command immediately, stopping all ad spend on that specific campaign until you manually reactivate it. **What data do I get when running `get_adgroup_analytics` via Pinterest Ads?** This tool reports metrics broken down by individual ad group. You can compare performance side-by-side to pinpoint exactly which groups need budget adjustments or creative changes. **Can I use the `get_account_analytics` function in Pinterest Ads?** Yes, it pulls core metrics for your entire account. You get a comprehensive view of impressions, clicks, CTR, and ROAS without needing multiple reports. **How does Pinterest Ads help me manage multiple campaigns using `list_campaigns`?** It lists all existing campaigns by name or ID. You can review the status of every campaign in one go, making it easy to identify which need updates or pausing.