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.
Ad accounts
An ad account is a connected account like any other, made for ads.
Connect
Each network’s own sign-in, from your Pluggzy dashboard. ChatGPT Ads takes an API key instead.
- 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"groupoperationads_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_alertsads_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_setNothing spends without your yes.
Built into the tools, on every network and in every AI app.
user_confirmed: true.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.{ "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.
- When a network says slow down, Pluggzy waits exactly the time it asks, to the second, and answers
rate_limitedwithretry_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.
Spend, budgets, cost per result and purchase value come in the ad account’s own currency.
Figures are the ones each network reports: spend, impressions, reach, clicks, conversions and the rest.
Meta Ads brings the last 90 days when an account connects. Older history fills in afterwards.
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.
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.
ads_write({ operation: "update_ad_campaign_status", body: { status: "paused" } })Reads the campaigns first, then pauses the worst one. Pausing needs no yes.
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.
ads_write({ operation: "update_ad_set", …, user_confirmed: true })A budget rise can spend more, so it asks first.
ads_read({ operation: "list_leads", … })The leads your form collected, read-only.
ads_read({ operation: "list_ads_alerts" })The ads that need attention, across the account.
ads_operations, ads_read and ads_write, with their refusals, in the reference.