MMetadata /docs
⌘K
Docs/Tools/get_campaign_by_wizard_id

get_campaign_by_wizard_id

Get full campaign details by its wizard campaign ID, including channels, audiences, ads, and budget configuration.

Read campaigns

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Get full campaign details by its wizard campaign ID, including channels, audiences, ads, and budget configuration.

                KEYWORDS: campaign, get, details, wizard, id, lookup, channels, audiences, ads, budget, configuration

                WHEN TO USE:
                - User wants to see full details of a specific campaign by its ID
                - User needs to inspect channel configurations, audiences, ad groups, or budget settings for a campaign
                - After creating a campaign, to verify its full configuration
                - To retrieve the complete campaign structure including all channel details

                RETURNS:
                Full campaign details in a structured format including:
                - Campaign ID, name, status, dates
                - Optimization group / budget group details
                - Per-channel configuration (enabled, daily budget, audiences, ad groups, lead gen forms, bid strategy)
                - Summary statistics (total channels, enabled channels, total daily budget, goal)

                PARAMETERS:
                - campaign_id: The wizard campaign ID (integer, required)

                CAMPAIGN ID SOURCES:
                - search_campaigns_by_names tool (returns campaign IDs)
                - create_campaign tool response (returns campaign_id)
                - Campaign management interface URLs

Arguments

ArgumentTypeNotes
campaign_id integer required The wizard campaign ID to retrieve details for

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_campaign_by_wizard_id","arguments":{"campaign_id":0}}}'

Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a list_ call immediately before.

arguments used
{
 "campaign_id": "[number redacted]"
}

Real, from the production server, in 1010 ms. The full response was 43,848 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "success": true,
 "timestamp": "2026-09-05T17:02:49.655252",
 "campaign_id": "[number redacted]",
 "campaign_name_actual": "[campaign_name_actual redacted]",
 "status": "Draft",
 "status_label": "Draft",
 "created_date": "2026-09-04T17:13:15.000Z",
 "start_date": null,
 "end_date": null,
 "optimization_group": {
  "id": null,
  "tag_name": null,
  "budget_type": null,
  "end_date": null
 },
 "channels": [
  {
   "id": "[number redacted]",
   "type": "FACEBOOK",
   "enabled": true,
   "daily_budget": 50,
   "audience_match_total": "[number redacted]",
   "connected": true,
   "bid_strategy": "AUTO_BID",
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   },
   "audiences": [
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "match_count": "[number redacted]"
    },
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "match_count": "[number redacted]"
    },
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "match_count": "[number redacted]"
    }
   ],
   "ad_groups": [
    {
     "id": "[id redacted]",
     "name": "[name redacted]",
     "creative_count": 1
    },
    {
     "id": "[id redacted]",
     "name": "[name redacted]",
     "creative_count": 1
    },
    {
     "id": "[id redacted]",
     "name": "[name redacted]",
     "creative_count": 1
    }
   ],
   "lead_gen_forms": [
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "completed": true
    }
   ],
   "landing_page_ids": [
    "[number redacted]"
   ]
  },
  {
   "id": "[number redacted]",
   "type": "GOOGLE_ADS",
   "enabled": false,
   "daily_budget": 50,
   "audience_match_total": 0,
   "connected": true,
   "bid_strategy": "MANUAL_CPC",
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   }
  },
  {
   "id": "[number redacted]",
   "type": "INSTAGRAM",
   "enabled": false,
   "daily_budget": 50,
   "audience_match_total": 0,
   "connected": true,
   "bid_strategy": "AUTO_BID",
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   }
  },
  {
   "id": "[number redacted]",
   "type": "LINKEDIN",
   "enabled": true,
   "daily_budget": 50,
   "audience_match_total": "[number redacted]",
   "connected": true,
   "bid_strategy": "METADATA_BID_AGENT",
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   },
   "audiences": [
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "match_count": "[number redacted]"
    },
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "match_count": "[number redacted]"
    },
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "match_count": "[number redacted]"
    }
   ],
   "ad_groups": [
    {
     "id": "[id redacted]",
     "name": "[name redacted]",
     "creative_count": 1
    },
    {
     "id": "[id redacted]",
     "name": "[name redacted]",
     "creative_count": 1
    },
    {
     "id": "[id redacted]",
     "name": "[name redacted]",
     "creative_count": 1
    }
   ],
   "lead_gen_forms": [
    {
     "id": "[number redacted]",
     "name": "[name redacted]",
     "completed": true
    }
   ],
   "landing_page_ids": [
    "[number redacted]"
   ]
  },
  {
   "id": "[number redacted]",
   "type": "MICROSOFT_ADS",
   "enabled": false,
   "daily_budget": 50,
   "audience_match_total": 0,
   "connected": true,
   "bid_strategy": "MANUAL_CPC",
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   }
  },
  {
   "id": "[number redacted]",
   "type": "REDDIT",
   "enabled": false,
   "daily_budget": 50,
   "audience_match_total": 0,
   "connected": true,
   "bid_strategy": null,
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   }
  },
  {
   "id": "[number redacted]",
   "type": "TWITTER",
   "enabled": false,
   "daily_budget": 50,
   "audience_match_total": 0,
   "connected": true,
   "bid_strategy": null,
   "meta_placement": {
    "mode": "AUTO",
    "placements": []
   
  … truncated

Other campaigns tools:

All 160 tools · machine-readable index