otheroauth2

Pinterest Ads

Pinterest Ads API for managing advertising accounts, campaigns, ad groups, ads, targeting, and reporting.

Verdict

Pinterest Ads lets your team pull campaign performance, check metric finalization, and manage ad groups and campaigns without leaving Switchy. @mention it to retrieve analytics across date ranges, verify conversion data is ready for reporting, or bulk-pause ad groups before a budget freeze. Marketing ops and paid social managers get the most value — they can audit spend, adjust pacing, and export targeting options for planning decks. The OAuth flow grants read and write access to all ad accounts you own or manage, so test carefully in a sandbox account if you're nervous about accidental edits.

Common use cases

  • Pull weekly campaign performance for client reports
  • Verify conversion metrics finalized before board meeting
  • Pause underperforming ad groups in bulk
  • Export targeting options for media plan
  • Audit active campaigns across all accounts

Integration

Vendor
Pinterest Ads
Category
other
Auth
OAUTH2
Tools
10
Composio slug
pinterest_ads

Tools

  • Get Ads Analytics

    Get synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range.

  • Get Metrics Ready State

    Check whether Pinterest conversion and non-conversion metrics are finalized for a UTC report date before relying on analytics results.

  • Get Targeting Options

    Get Pinterest's valid targeting values for a targeting type, such as age buckets, gender, locale, location, interests, or keywords.

  • List Ad Accounts

    List advertiser accounts the connected Pinterest user owns or can access, including the IDs needed by all other Ads tools.

  • List Ad Groups

    List ad groups for an advertiser, filter by parent campaigns, or look up specific ad groups by ID.

  • List Ads

    List ads for an advertiser, filter by one hierarchy level, or look up specific ads by ID. Archived and draft ads must be requested explicitly with entity_statuses.

  • List Campaigns

    List campaigns for an advertiser, or look up specific campaigns by ID using campaign_ids. Archived and draft campaigns must be requested explicitly with entity_statuses.

  • Update Ad Groups

    Rename, pause, or resume up to 30 existing ad groups. Setting status to ACTIVE can restart delivery and incur spend under existing budgets. Budget, bid, targeting, schedule, and restricted-setting changes are not exposed.

  • Update Ads

    Rename, pause, or resume up to 30 existing Pinterest ads. Setting status to ACTIVE can restart delivery and incur spend under existing budgets. Creative, Pin, destination, tracking, and disclosure changes are not exposed.

  • Update Campaigns

    Rename, pause, or resume up to 30 existing campaigns. Setting status to ACTIVE can restart delivery and incur spend under existing budgets. Budget, schedule, objective, archive, and restricted-setting changes are not exposed.

Setup

Setup guide

  1. 11. Open your Switchy workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration', search for Pinterest Ads, and select it. 3. Click 'Connect' to launch Pinterest's OAuth consent screen in a new window. 4. Sign in with the Pinterest account that owns or has access to your ad accounts, then review the requested scopes: read and write access to ads, campaigns, ad groups, and analytics. 5. Click 'Allow' to authorize Switchy; you'll return to the workspace with a green 'Connected' badge. 6. Create or open a Project, type '@Pinterest Ads list ad accounts' in the chat, and send — you should see a list of advertiser IDs and names confirming the connection works. 7. To invoke any tool, @mention Pinterest Ads followed by your request (e.g. '@Pinterest Ads get ads analytics for campaign 123 last 7 days'). 8. If you need to revoke access later, visit pinterest.com/settings/security and remove Switchy from authorized apps.

What teammates see: by default, memories from Pinterest Ads are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Weekly Campaign Summary

@Pinterest Ads get ads analytics for all campaigns in ad account 549761234567 for the last 7 days, grouped by campaign

Check Metrics Ready

@Pinterest Ads check if metrics are ready for ad account 549761234567 for yesterday's UTC date

Pause Low Performers

@Pinterest Ads list ad groups for ad account 549761234567, then get analytics for the last 30 days and show me which have CTR under 0.5% so I can pause them

Export Interest Targets

@Pinterest Ads get all valid targeting options for interest targeting type

Audit Account Structure

@Pinterest Ads list all campaigns for ad account 549761234567 including archived and draft, then list all ad groups under each campaign

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Pinterest Ads show me performance metrics for campaign ID 123456789 over the last 7 days, broken down by ad group

Output

Here's an illustrative summary of campaign 123456789 performance from the past week: • Ad Group A (Active): 45,200 impressions, 1,240 clicks (2.74% CTR), $89.50 spend, 18 conversions ($4.97 CPA) • Ad Group B (Active): 32,100 impressions, 890 clicks (2.77% CTR), $67.20 spend, 12 conversions ($5.60 CPA) • Ad Group C (Paused): 8,400 impressions, 180 clicks (2.14% CTR), $15.30 spend, 2 conversions ($7.65 CPA) Total campaign spend: $172.00 across 85,700 impressions and 32 conversions. Ad Group A is your top performer by conversion volume and efficiency.

Notes

This example shows read-only analytics retrieval. Before pulling metrics, use Get Metrics Ready State to confirm the UTC date's data is finalized—Pinterest typically needs 24-48 hours to process conversion events. The tool requires ad_account_id and supports filtering by campaign, ad group, or ad level with flexible date ranges.

Prompt

@Pinterest Ads pause ad groups 987654321 and 987654322, then resume ad group 111222333 to restart delivery

Output

Illustrative confirmation of ad group status changes: ✓ Ad Group 987654321 ("Spring Promo - Shoes") set to PAUSED. Delivery stopped; no new impressions will accrue. ✓ Ad Group 987654322 ("Spring Promo - Bags") set to PAUSED. Delivery stopped. ✓ Ad Group 111222333 ("Summer Preview - Apparel") set to ACTIVE. Delivery resumed under existing $50/day budget and current bid strategy. All changes applied immediately. Monitor spend closely—reactivated ad groups can begin serving within minutes if targeting and creative are approved.

Notes

This write action demonstrates batch status updates (up to 30 ad groups per call). Setting status to ACTIVE restarts spend under the ad group's existing budget and bid settings—there's no confirmation prompt before charges resume. You'll need the ad_account_id and valid ad_group_ids. Budget or targeting changes require separate API calls not shown here.

Prompt

@Pinterest Ads list all active campaigns for ad account 549876543210, then draft a one-paragraph performance summary highlighting the top spender and lowest CPA

Output

Illustrative campaign list and AI synthesis: Active campaigns for account 549876543210: • Campaign "Holiday Gift Guide" (ID: 123): $1,240 spend, 52 conversions ($23.85 CPA) • Campaign "New Arrivals Q1" (ID: 456): $890 spend, 78 conversions ($11.41 CPA) • Campaign "Brand Awareness" (ID: 789): $2,100 spend, 45 conversions ($46.67 CPA) Summary: Your "Brand Awareness" campaign is the top spender at $2,100 but has the highest cost per acquisition at $46.67. Meanwhile, "New Arrivals Q1" delivers the most efficient performance with a $11.41 CPA across 78 conversions, making it the best candidate for budget reallocation if you're optimizing for conversion efficiency.

Notes

This synthesis example pairs List Campaigns (filtered by entity_statuses=ACTIVE) with the AI's reasoning to surface insights across your account. The MCP returns raw campaign metadata and requires Get Ads Analytics for spend/conversion metrics—this example assumes both calls happened. Useful for weekly reviews or budget planning discussions with your team.

Use-case deep-dives

E-commerce team weekly ad spend review

When Pinterest Ads MCP beats manual dashboard checks for DTC brands

A 3-person e-commerce team running 12 Pinterest campaigns checks performance every Monday morning to reallocate budget before the week starts. The Pinterest Ads MCP pulls analytics for all campaigns in one Switchy prompt, surfaces which ad groups hit ROAS targets, and flags metrics that aren't finalized yet with the ready-state check. The team pauses underperformers and adjusts bids without opening the Ads Manager UI. This works cleanly if you run under 50 campaigns and check weekly or daily. If you're a larger brand with 200+ campaigns or need hourly optimization, you'll want a dedicated BI tool instead of ad-hoc Switchy queries. For small DTC teams that treat Pinterest as a secondary channel after Meta, this MCP turns a 20-minute dashboard session into a 3-minute Switchy conversation.

Agency client campaign setup at scale

Where this MCP falls short for multi-client agencies

A 6-person agency manages Pinterest campaigns for 15 clients and needs to clone campaign structures, update targeting, and pull cross-account reports. The Pinterest Ads MCP lists ad accounts and reads targeting options, but the 10-tool scope doesn't include bulk campaign creation or cross-account rollups. You can update 30 ad groups at once, but building net-new campaigns still requires the Pinterest UI or a custom script. If you're an agency running identical playbooks across clients, you'll hit the MCP's ceiling fast. The OAuth2 flow also means each client must authorize Switchy separately, which adds friction at onboarding. This MCP is better suited for a single-brand in-house team that tweaks existing campaigns than for agencies spinning up new accounts weekly.

Freelance media buyer budget pacing check

When this MCP wins for solo consultants juggling 3-5 accounts

A freelance media buyer manages Pinterest campaigns for 4 small brands and checks daily spend against monthly budgets to avoid overpacing. The Pinterest Ads MCP lists campaigns, pulls yesterday's analytics, and confirms metrics are finalized before the buyer reports to clients. All of this happens in Switchy without switching between four Pinterest logins. The 10-tool set covers the read-heavy workflow a solo operator needs: list entities, get performance, check data readiness. You're not building campaigns in Switchy, just monitoring and making small tweaks like pausing an ad group that burned budget overnight. If you're a freelancer with under 10 total accounts and you bill for strategic oversight rather than campaign production, this MCP keeps you out of the Pinterest UI for 80% of your daily checks.

Frequently asked

What does the Pinterest Ads MCP let me do in Switchy?

It pulls campaign performance data, checks metric readiness, and manages your Pinterest ad campaigns, ad groups, and individual ads. You can pause or resume campaigns, fetch targeting options like interests and demographics, and export analytics for specific date ranges. It reads from and writes to your Pinterest advertiser accounts through OAuth.

Do I need admin access to my Pinterest Ads account to connect this?

You need owner or admin access to the advertiser accounts you want to manage. When you authenticate via OAuth, Pinterest will show which accounts you can access. The MCP lists those accounts first, then you pick which ones to work with. Contributors or analysts with view-only permissions won't be able to pause campaigns or update ad groups.

Can this MCP create new Pinterest ad campaigns from scratch?

No. The tools let you list, update, pause, and resume existing campaigns and ad groups, but there's no tool for creating new campaigns or ads. If you need to launch a new campaign, do that in the Pinterest Ads Manager first, then use Switchy to pull analytics or manage status changes.

How is this different from exporting CSV reports from Pinterest Ads Manager?

The MCP fetches analytics programmatically, so you can pull yesterday's spend or CTR into a Switchy workflow without logging into the web UI. It also checks metric readiness before you rely on the numbers, which the CSV export doesn't flag. For one-off reports, the Manager is faster; for recurring pulls or multi-account rollups, the MCP saves time.

Who on my team should connect the Pinterest Ads account?

Whoever owns or administers your Pinterest advertiser accounts. That person authenticates once via OAuth, and Switchy stores the token. Other team members can then run the tools without re-authenticating, as long as your Switchy workspace permissions allow it. If you rotate ad account ownership, you'll need to reconnect.

More other MCPs

See all other MCPs →

Data last verified 62 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.