MMetadata /docs
Docs/Tools/search_campaigns_by_names

search_campaigns_by_names

Search for campaigns by name to get campaign details, IDs, and status.

Read campaigns

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

What it does

Search for campaigns by name to get campaign details, IDs, and status.

                KEYWORDS: campaign, search, find, lookup, status, active, paused, draft, marketing, advertising

                **USE THIS TOOL WHEN THE USER ASKS ABOUT:**
                - Campaign details, information, or status
                - Finding a campaign by name
                - Getting campaign IDs
                - Checking if a campaign exists
                - Looking up campaign status (active, paused, draft)
                - Any question containing words like: "campaign", "show me", "find", "search", "list", "details", "status"

                **ALWAYS use this tool first** before launching, updating, or referencing any campaign.

                SEARCH FEATURES:
                - Partial, case-insensitive matching (e.g., "Q1" matches "Q1_2026_Campaign")
                - Returns campaign ID, full name, and current status
                - Searches up to 150 visible campaigns per term

                PARAMETERS:
                - campaign_names: Array of campaign name strings to search for (required)

                RETURNS:
                {
                    "found_campaigns": [
                        {
                            "id": 159490,
                            "name": "LinkedIn_BoFu_Q1_2026",
                            "statusLabel": "Active"
                        }
                    ],
                    "missing_names": ["NonExistent"],
                    "total_found": 1
                }

                STATUS LABELS: Active, Paused, Draft, Completed, Unknown

                Use returned campaign IDs with launch_campaign or manage_campaign tools.

                Anchor all date-related decisions to the REAL current date — call get_current_date if you are not already certain what today is.

Arguments

ArgumentTypeNotes
campaign_names array required Array of campaign names or partial names to search for (case-insensitive, partial matching)

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":"search_campaigns_by_names","arguments":{"campaign_names":[]}}}'

Response

No recorded response. This tool needs arguments that only exist inside an account, so no response is recorded here. 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