Ad Manager Facebook Create Page Lead Form

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

WRITEghl.ad_manager_facebook_create_page_lead_form

• Contract tier: agent_ready
• Risk: write
• Catalog version: 2026-07-12.2
• Descriptor hash: e9dba3cc278b0cd21b2350b00c729d374079974935933bde88dcf22779c695b1

Create a lead form for one Facebook page in GHL Ad Manager. Use this Marketing > Ad Manager write tool to create, update, connect, duplicate, pause, resume, publish, or otherwise change Facebook advertising resources. Do not use it for live ad changes unless the user explicitly requested that action. GHL category: Marketing. This writes to GoHighLevel and may change account data.

Request Body

{
  "jsonrpc": "2.0",
  "id": "ghl-ad-manager-facebook-create-page-lead-form-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_facebook_create_page_lead_form",
    "arguments": {
      "pageId": "pageId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "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
    },
    "pageId": {
      "type": "string",
      "description": "pageId path parameter required by /ad-publishing/facebook/page/:pageId/forms."
    },
    "tenantId": {
      "type": "string",
      "description": "Tenant ID from list_tenants."
    }
  },
  "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-facebook-create-page-lead-form-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_facebook_create_page_lead_form",
    "arguments": {
      "pageId": "pageId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123"
    }
  }
}'

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-facebook-create-page-lead-form-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_facebook_create_page_lead_form",
    "arguments": {
      "pageId": "pageId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123"
    }
  }
}),
});
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-facebook-create-page-lead-form-example",
  "method": "tools/call",
  "params": {
    "name": "ghl.ad_manager_facebook_create_page_lead_form",
    "arguments": {
      "pageId": "pageId_123",
      "body": {},
      "query": {},
      "tenantId": "tenantId_123"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool ghl.ad_manager_facebook_create_page_lead_form 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."
}