PluggzyDocs

Ads

Your ad accounts on nine networks, in any AI app. Ask how your ads did, which campaign wastes money, or to boost a post: your AI app finds the operation, reads the figures and makes the change. Anything that can spend money waits for your yes.

9ad networks, each with its own sign-in
3tools, the same on every network
336operations, from campaigns to insights
Your yesbefore anything that spends or gives access

Ad accounts

An ad account is a connected account like any other, made for ads.

What it isYour ad account on a network, connected to Pluggzy. Meta Ads covers your Facebook and Instagram ads. Your AI app reads its campaigns and figures, and changes them when you ask.
On your planOne connected account, like any other. One Meta Ads sign-in that reaches several ad accounts counts once.
Ad spendBilled by each network to your own ad account. Pluggzy doesn’t pay for ads.
Its own keyEach ad account gets an access key that reaches that one account and no other.
Ads onlyNo messages or DMs: an ad account runs ads. Chats stay on the inbox channels.

Connect

Each network’s own sign-in, from your Pluggzy dashboard. ChatGPT Ads takes an API key instead.

NetworkSign in withStructure
Meta AdsFacebook and Instagram adsSign inFacebook Login for BusinessStructureCampaign › Ad set › Ad
Google AdsSign inGoogle sign-inStructureCampaign › Ad group › Ad
LinkedIn AdsSign inLinkedIn sign-inStructureCampaign group › Campaign › Creative
TikTok AdsSign inTikTok sign-inStructureCampaign › Ad group › Ad
Pinterest AdsSign inPinterest sign-inStructureCampaign › Ad group › Promoted Pin
X AdsSign inTwo sign-ins: your X account, then its adsStructureCampaign › Line item › Promoted tweet
Reddit AdsSign inReddit sign-inStructureCampaign › Ad group › Ad
Microsoft AdsSearch campaignsSign inMicrosoft sign-inStructureCampaign › Ad group › Ad
ChatGPT AdsSign inAn API key from ChatGPT Ads Manager (Settings), pasted on Pluggzy’s connect pageStructureCampaign › Ad group › Chat card
  • Paste the ChatGPT Ads key on Pluggzy’s connect page, never in a chat.
  • X Ads asks twice: first your X account, then access to its ads.

Three tools

The same three on every network. Your AI app picks the right one; you just ask.

ads_operationsReadFirst, to find what it can do: 336 operations on campaigns, ad sets, ads, budgets, boosts, bids, targeting, audiences, conversions, creatives, product catalogs, lead forms, rules, automations and insights, each with its parameters.query: "pause campaign"groupoperation
ads_readReadTo look: spend, results, daily metrics, the campaign tree, top ads, alerts, audiences, leads, previews and reach estimates. Changes nothing.get_ads_timelineget_ad_treelist_ads_alerts
ads_writeWriteTo change: create campaigns, ad sets and ads, boost a post, pause and resume, budgets, bids, targeting, audiences, deletions. Anything that can spend or give access waits for your yes.boost_postupdate_ad_campaign_statusupdate_ad_set

Nothing spends without your yes.

Built into the tools, on every network and in every AI app.

Spend or accessYour yes
Anything that can spend money or give someone access runs only after you say yes in the chat. Your AI app then sends user_confirmed: true.
PausingAny time
Pausing never needs a yes. Stopping spend is always allowed, on every network.
New adsPaused
Your AI app is told to send new ads paused, unless you say launch.

When the yes is missing

Nothing runs and nothing is retried behind your back: the tool answers with a code your AI app understands.

confirmation_requiredIt can spend money or give access. Your AI app tells you what will run, then calls again once you agree.
unsupportedThat operation isn’t on this network, like a boost on Microsoft Ads.
invalid_requestThe network refused a value; fields says which.
rate_limitedThe network itself asked to slow down. retry_after_seconds is exactly the wait it asked for.
Example refusal
isError
{
  "error": "boost_post can spend money or grant access. Tell the user exactly what it will do, then call again with user_confirmed: true once they agree.",
  "code": "confirmation_required"
}

Limits

Pluggzy adds no limits of its own to an ad account: no daily cap, no per-minute cap, no spacing. A change goes out as soon as your AI app asks. Only each 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.
  • Your yes still comes first: anything that can spend money or give access waits for it in the chat.
  • Pausing counts as a change, never as spending: it never waits for a yes.

Money and figures

What the numbers your AI app reads are, and where they come from.

In your account’s currency.

Spend, budgets, cost per result and purchase value come in the ad account’s own currency.

From the network itself.

Figures are the ones each network reports: spend, impressions, reach, clicks, conversions and the rest.

90 days of Meta at connect.

Meta Ads brings the last 90 days when an account connects. Older history fills in afterwards.

Cut to fit, and says so.

A very long answer comes back trimmed with truncated: true. Narrow it: dates, a limit, one campaign.

How your AI asks

You don’t name operations. Ask the way you’d ask a colleague; your AI app turns it into calls.

“How did my Meta ads do this week compared to last week?”ads_read({ operation: "get_ads_timeline", params: { compare: true } })
Daily spend and results for the week, next to the week before, in the account’s currency.
“Which Google Ads campaign has the worst cost per conversion? Pause it.”ads_write({ operation: "update_ad_campaign_status", body: { status: "paused" } })
Reads the campaigns first, then pauses the worst one. Pausing needs no yes.
“Boost my last Instagram post for €10 a day for 5 days to people in France aged 25–40.”ads_write({ operation: "boost_post", …, user_confirmed: true })
Your AI app states the budget, dates and audience, waits for your yes, then creates it paused or live, as you said.
“Raise the budget of my best TikTok ad group by 20%.”ads_write({ operation: "update_ad_set", …, user_confirmed: true })
A budget rise can spend more, so it asks first.
“List the leads from my LinkedIn lead form this month.”ads_read({ operation: "list_leads", … })
The leads your form collected, read-only.
“Which of my ads has an alert or got rejected?”ads_read({ operation: "list_ads_alerts" })
The ads that need attention, across the account.
Every input and outputads_operations, ads_read and ads_write, with their refusals, in the reference.
Ads tools
Generated from pluggzy.com/api/docs · 42 toolsSomething unclear? Write to support · Status