Ad Manager Google Delete Ad Account

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

DESTRUCTIVEghl.ad_manager_google_delete_ad_account

• Contract tier: agent_ready
• Risk: destructive
• Catalog version: 2026-07-12.2
• Descriptor hash: de0735cd31a8779ac5758c57f2438b9428e7b4f2495bb4b88240f2bd3483d80c

Delete or disconnect one Google ad account from GHL Ad Manager. Use this destructive Marketing > Ad Manager tool only when the user explicitly asks to delete, remove, or disconnect Google advertising resources. For validation, create disposable test data first and clean it up in the same flow. GHL category: Marketing. This can delete, remove, cancel, void, or disconnect GHL data; only use it when the user explicitly asks for that side effect.

Request Body

{
  "jsonrpc": "2.0",
  "id": "ghl-ad-manager-google-delete-ad-account-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_google_delete_ad_account",
    "arguments": {
      "adAccountId": "adAccountId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "required": [
    "adAccountId"
  ],
  "properties": {
    "body": {
      "type": "object",
      "description": "Request body for this GHL Ad Manager operation, using only fields documented by GHL for this endpoint.",
      "additionalProperties": true
    },
    "query": {
      "type": "object",
      "description": "Optional GHL-supported query parameters for this endpoint, such as pagination, account, date range, search, or filtering fields from the official docs.",
      "additionalProperties": true
    },
    "tenantId": {
      "type": "string",
      "description": "Tenant ID from list_tenants."
    },
    "adAccountId": {
      "type": "string",
      "description": "adAccountId path parameter required by /ad-publishing/google/ad-accounts/:adAccountId."
    },
    "confirmApply": {
      "type": "string",
      "description": "Set to \"CONFIRM APPLY\" to execute destructive operations when safe mode is enabled."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the GHL MCP operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Tool-specific GHL or local navigation result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe execution, routing, and timing metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe error details when ok is false; credential values are never returned."
    }
  },
  "description": "Normalized GHL MCP response envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "ghl-ad-manager-google-delete-ad-account-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_google_delete_ad_account",
    "arguments": {
      "adAccountId": "adAccountId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "ghl-ad-manager-google-delete-ad-account-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_google_delete_ad_account",
    "arguments": {
      "adAccountId": "adAccountId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "ghl-ad-manager-google-delete-ad-account-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_google_delete_ad_account",
    "arguments": {
      "adAccountId": "adAccountId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123",
      "confirmApply": "confirmApply_example"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool ghl.ad_manager_google_delete_ad_account executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}