MMetadata /docs
⌘K
Docs/Tools/manage_campaign

manage_campaign

Manage a campaign by pausing or restarting it.

Destructive campaigns

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Manage a campaign by pausing or restarting it.

                KEYWORDS: pause, stop, restart, resume, unpause, campaign, control, manage, halt

                WHEN TO USE:
                - User asks to "pause campaign X"
                - User wants to "stop campaign Y"
                - User requests to "restart campaign Z"
                - User wants to "resume campaign A"
                - User asks to "unpause campaign B"

                ACTIONS:
                - pause: Temporarily pause an active campaign to stop ad serving and budget spend
                - restart: Resume a paused campaign to continue ad serving and budget spend

                REQUIRED PARAMETERS:
                - campaign_id: The unique identifier of the campaign to manage (integer, required)
                - action: The action to perform - "pause" or "restart" (string, required)

                CAMPAIGN ID SOURCES:
                Campaign IDs can be obtained from:
                - search_campaigns_by_names tool
                - create_campaign tool response
                - Campaign management interface URLs

                IMPORTANT VALIDATION REQUIREMENTS:
                - **CRITICAL**: You can ONLY pause campaigns that are currently "Active"
                - **CRITICAL**: You can ONLY restart campaigns that are currently "Paused"
                - Before attempting to pause or restart, use search_campaigns_by_names to verify the current campaign status

Arguments

ArgumentTypeNotes
campaign_id integer required The unique identifier of the campaign to manage
action string required The action to perform: 'pause' to stop the campaign, 'restart' to resume it
one of: pause, restart

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":"manage_campaign","arguments":{"campaign_id":0,"action":"pause"}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other campaigns tools:

All 160 tools · machine-readable index