PluggzyDocs

Pinterest Ads

InsightsBoostsTargetingConversions
InsightsBoostsTargetingConversions

Your Pinterest ads in any AI app: read spend and results, create campaigns, promote Pins, set budgets and targeting, build audiences and send conversions. Anything that can spend waits for your yes.

Connect with
Pinterest sign-in
Structure
Campaign › Ad group › Promoted Pin
Tools
3
Nonelimits of Pluggzy’s own: no daily cap, no spacing
Exactwait when the network says slow down, to the second
Pausednew ads, unless you say launch
Your yesbefore anything that spends or gives access

What works

What your AI app can do on a Pinterest Ads account, from the network’s own API.

CreateCampaigns, ad groups and Promoted Pins, each with a goal.engagementtrafficawarenessvideo_views
Boost a postPromote one of your Pins.
BudgetsDaily or lifetime, at least $5. Accounts with campaign budgets need an endDate and a lifetime budget.
TargetingCountry, region, metro, postal code, age, gender, language and interests. With targeting search and reach estimates.
After launchStatus and budget, ad group names and deletions. Targeting and creative can’t change once it runs.
AudiencesCustomer lists, made on first use.
ConversionsThe Conversions API, with Event Quality Score.
Not hereNo dry run and no lead forms.

Limits

Pluggzy adds no limits of its own to a Pinterest Ads ad account: no daily cap, no per-minute cap, no spacing. A change goes out as soon as your AI app asks. Only the network’s own rate limits apply.

ActionPluggzy’s own limitTools
Readsspend, results, insights, leadsNonethe network’s own rate limits applyads_read
Spending changesnew ads, boosts, budgets, bids, resumingNonethe network’s own rate limits applyads_write
Other changespausing, audiences, creatives, keywords, conversionsNonethe network’s own rate limits applyads_write
Deletionscampaigns, ad sets, ads, audiencesNonethe network’s own rate limits applyads_write
ReadsNone
spend, results, insights, leads
the network’s own rate limits apply
ads_read
Spending changesNone
new ads, boosts, budgets, bids, resuming
the network’s own rate limits apply
ads_write
Other changesNone
pausing, audiences, creatives, keywords, conversions
the network’s own rate limits apply
ads_write
DeletionsNone
campaigns, ad sets, ads, audiences
the network’s own rate limits apply
ads_write
  • When a network says slow down, Pluggzy waits exactly the time it asks, to the second, and answers rate_limited with retry_after_seconds. Your AI app calls again after it. Nothing is queued behind your back.
  • Spend, budgets and results come in the ad account’s own currency.
  • Pausing never waits for a yes.

Connect Pinterest Ads

Pinterest’s own sign-in, from your Pluggzy dashboard.

  1. 1In your Pluggzy dashboard, choose Connect an account and pick Pinterest Ads.
  2. 2Choose Continue with Pinterest and approve access to your ads on Pinterest’s screen.
  3. 3You come back to Pluggzy and the ad account shows up.
  4. 4Ask your AI app: “How did my Pinterest ads do this week?”

Tools

Exactly what your AI app receives from tools/list. The same three tools work on every ad network.

3 tools · 2 read · 1 write
Ads3
The same tools on every ad networkads_operations, ads_read and ads_write work the same on all nine networks; an operation that isn’t on Pinterest Ads is refused with unsupported.
Ads tools
Generated from pluggzy.com/api/docs · 42 toolsSomething unclear? Write to support · Status