Pinterest Ads Manager
by Pinterest
Create, manage, and optimize Pinterest advertising campaigns, ad groups, and promoted pins via the Pinterest Marketing API
How agents use Pinterest Ads Manager
- ✓Agent retrieves weekly campaign analytics to generate a paid Pinterest performance report and flag campaigns with high CPM but low saves
- ✓Agent creates a new promoted pin campaign when a blog post or product collection is published in the CMS
- ✓Agent pauses promoted pins with CTR below a defined threshold based on ad-level analytics data
- ✓Agent scales daily budgets on high-converting campaigns and reduces spend on underperformers using campaign analytics
- ✓Agent refreshes retargeting audiences from Pinterest Tag pixel data and updates ad group targeting to match new visitor segments
- ✓Agent creates a Pin from a product image URL and immediately promotes it within a running ad group
Agent actions
Inputs: status, pageSize, order
Returns: campaigns, total, bookmark
Inputs: name, objectiveType, budgetType, dailySpendCap, lifetimeSpendCap, isCampaignBudgetOptimization, status, startTime, endTime
Returns: campaignId, success
Inputs: campaignId, name, dailySpendCap, lifetimeSpendCap, status
Returns: success, campaignId
Inputs: campaignId, status, pageSize
Returns: adGroups, total, bookmark
Inputs: campaignId, name, billableEvent, budgetInMicroCurrency, bidInMicroCurrency, bidStrategyType, optimizationGoal, targeting, startTime, endTime, status
Returns: adGroupId, success
Inputs: adGroupId, status, pageSize
Returns: ads, total, bookmark
Inputs: adGroupId, pinId, name, creativeType, destinationUrl, status
Returns: adId, success
Inputs: objectType, objectId, status
Returns: success, newStatus
Inputs: campaignIds, startDate, endDate, columns, granularity, clickWindowDays
Returns: data, totalSpend, totalImpressions, totalClicks, averageCtr, averageCpm, averageCpc, totalConversions
Inputs: adIds, startDate, endDate, columns, granularity
Returns: data, totalSpend, totalImpressions, totalClicks, totalSaves
Inputs: boardId, title, description, link, mediaSourceType, imageUrl, videoId, altText
Returns: pinId, pinUrl, success
Inputs: pageSize, order
Returns: audiences, total, bookmark
Inputs: name, rule, audienceType, description
Returns: audienceId, success, audienceSize
Example workflows
Automated seasonal campaign launch
Create a new campaign and promoted pin ads end-to-end whenever a seasonal collection is published
Weekly performance reporting
Pull campaign and ad analytics every week, identify low-performing promoted pins, and pause them automatically
Retargeting audience refresh
Rebuild visitor retargeting audiences from Pinterest Tag data and update ad group targeting automatically
About Pinterest Ads Manager
- Vendor
- Pricing Always review details with the vendor
- Free — The Pinterest Marketing API is free to use. Costs are incurred only through actual ad spend on the platform. Standard API access requires app review approval.
- Authentication
- OAuth 2.0
- Rate limit Always review details with the vendor
- 6000 requests / minute
- Compatible nodes
- AgentResourceOutput
- Website
- https://ads.pinterest.com
Build an AI workflow with Pinterest Ads Manager
Use the Agentic Planner to design, visualize, and connect Pinterest Ads Manager with your other tools.
Open Agentic Planner