PluggzyDocs

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.

3 tools · 2 read · 1 write
Ads3

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.

Permission View profiles
Input3 params · 0 required
operationstring
querystring
words, e.g. "pause campaign"
groupstring
OutputstructuredContent
{
  "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)."
    }
  ]
}
What the gate didExample09:41:02 → 09:41:02
  1. Received09:41:02
  2. AnsweredNo network call
Text content starts with “2 operation(s).” · Can refuse withnot_foundinvalid_requestpermission

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.

Permission View profilesLimit No limit of Pluggzy’s own · the network’s own rate limits apply
Input4 params · 1 required
accountstring
ad account_id (list_accounts), when several
operationstringrequired
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
OutputstructuredContent
{
  "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."
    }
  ]
}
What the gate didExample09:41:02 → 09:41:03
  1. Received09:41:02
  2. No limit of Pluggzy’s ownOnly the network’s rate limits
  3. Sent09:41:03
Text content starts with “Meta Ads: get_ads_timeline done.” · Can refuse withnot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

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.

Permission Send messages & postsLimit No limit of Pluggzy’s own · the network’s own rate limits applyConfirm with the user first
Input5 params · 1 required
accountstring
ad account_id (list_accounts), when several
operationstringrequired
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
user_confirmedboolean
the user approved this change
OutputstructuredContent
{
  "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."
    }
  ]
}
What the gate didExample09:41:02 → 09:41:03
  1. Received09:41:02
  2. No limit of Pluggzy’s ownOnly the network’s rate limits
  3. Sent09:41:03
Text content starts with “Meta Ads: update_ad_campaign_status done.” · Can refuse withconfirmation_requirednot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

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.
Example refusal
isError
{
  "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"
  }
}
Codes on every channelcooldown and permission work the same as everywhere else in Pluggzy.
Errors
Generated from pluggzy.com/api/docs · 42 toolsSomething unclear? Write to support · Status