Ads tools
Three tools for every ad network: find an operation, read, change. They work the same on Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads and ChatGPT Ads, with no limits of Pluggzy’s own: only each network’s rate limits apply.
Tools
Exactly what your AI app receives from tools/list. ads_write changes your ad account: anything that can spend or give access needs the user’s yes first.
Finds ads operations for Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads, ChatGPT Ads (campaigns, budgets, boosts, targeting, audiences, conversions, creatives, leads, insights…) by words or group; with operation, its parameters and body.
operationstringquerystringgroupstring{ "structuredContent": { "operations": [ { "name": "update_ad_campaign_status", "summary": "Pause or resume a campaign", "kind": "write", "needs_user_confirmed": true }, { "name": "bulk_update_ad_campaign_status", "summary": "Pause or resume many campaigns", "kind": "write", "needs_user_confirmed": true } ] }, "content": [ { "type": "text", "text": "2 operation(s)." } ] }
- Received09:41:02
- AnsweredNo network call
Runs a read-only ads operation (see ads_operations): campaigns with spend and results, daily metrics, insights, audiences, leads. Money is in the account's currency.
accountstringaccount_id (list_accounts), when severaloperationstringrequiredads_operationsparamsobjectbodyobject{ "structuredContent": { "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e", "provider": "metaads", "operation": "get_ads_timeline", "result": { "rows": [ { "date": "2026-11-16", "currency": "EUR", "spend": 112.4, "impressions": 18420, "clicks": 391, "ctr": 2.12, "conversions": 14 }, { "date": "2026-11-17", "currency": "EUR", "spend": 118.9, "impressions": 19105, "clicks": 402, "ctr": 2.1, "conversions": 16 } ] } }, "content": [ { "type": "text", "text": "Meta Ads: get_ads_timeline done." } ] }
- Received09:41:02
- No limit of Pluggzy’s ownOnly the network’s rate limits
- Sent09:41:03
Runs an ads operation that changes the account (see ads_operations): create, boost, pause, budgets, targeting, deletions. needs_user_confirmed ones spend money or grant access: tell the user what will run (budget, dates, audience) and set user_confirmed only once they agree. New ads can go live at once: send a paused status to review first.
accountstringaccount_id (list_accounts), when severaloperationstringrequiredads_operationsparamsobjectbodyobjectuser_confirmedboolean{ "structuredContent": { "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e", "provider": "metaads", "operation": "update_ad_campaign_status", "result": { "success": true, "campaignId": "120214455667788990", "status": "PAUSED" } }, "content": [ { "type": "text", "text": "Meta Ads: update_ad_campaign_status done." } ] }
- Received09:41:02
- No limit of Pluggzy’s ownOnly the network’s rate limits
- Sent09:41:03
Errors
Every refusal has a code your AI app can act on, and a message that says what to do.
Ads refusals
Nothing is queued or retried behind your back: your AI app reads the code and the message, and fixes the call or asks you.
confirmation_requiredads_write only. The operation can spend money or give access and user_confirmed wasn’t true. Tell the user what will run, then call again.unsupportedThe operation doesn’t work on this ad account’s network (no boosts on Microsoft Ads or ChatGPT Ads). The message says which networks it’s for.invalid_requestThe network refused the call: the message starts with its name, and fields names the values to fix.not_foundNo operation by that name: the message lists close ones.rate_limitedThe network itself asked to slow down (its own rate limit; Pluggzy has none of its own on ad accounts). retry_after_seconds is exactly the wait it asked for: call again after it.{ "error": "Meta Ads refused: the daily budget is below this ad account’s minimum.", "req_id": "req_7f3a9c21e4b8", "code": "invalid_request", "fields": { "budgetAmount": "below the ad account’s minimum daily budget" } }
cooldown and permission work the same as everywhere else in Pluggzy.