Pinterest Ads
Pinterest Ads API for managing advertising accounts, campaigns, ad groups, ads, targeting, and reporting.
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
- Create or open a Switchy Project.
- Open Integrations and connect Pinterest Ads.
- Authorise through oauth2. Switchy stores the connection against your org.
- Everyone in the Project can now @-mention the Pinterest Ads tools in chat.
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.