List Wizard Campaigns
list_wizard_campaignsRead-only
List wizard (Metadata-native) campaigns for the current account with pagination, sorting, and experiment-status filtering.
KEYWORDS: campaigns, list, browse, wizard, native, all campaigns, campaign list, launched campaigns, paused campaigns, active campaigns
USE THIS TOOL WHEN THE USER ASKS:
- "Show me all campaigns" / "List campaigns" / "What campaigns do we have?"
- "Show active campaigns" / "List paused campaigns" / "Show completed campaigns"
- "Show recent campaigns" / "Last N campaigns"
- "Campaigns sorted by spend / leads / CPL / created date"
- Page-by-page campaign browsing for the campaigns UI
DO NOT USE if the user:
- Wants details on ONE SPECIFIC campaign by name → use search_campaigns_by_names
- Wants budget group info (not campaigns) → use list_budget_groups / get_budget_group
- Wants per-experiment performance → use experiment_performance_stats / search_experiments
TWO INDEPENDENT FILTERS (COMBINE TO MATCH UI TABS):
1) status — filters by CAMPAIGN status. Accepts a comma-separated subset of: Draft, Launched, Finished.
- Draft: the campaign exists but has never been launched.
- Launched: the campaign has been launched (experiments may be Active, Paused, or idle).
- Finished: the campaign has reached its end date.
- Omit to include all three.
2) experiment_statuses — filters by EXPERIMENT status inside each campaign. Accepts a comma-separated subset of:
Active, WithoutSpend, Paused, Completed, Failed. Omit to include all five.
HOW TO MIX THEM (mirrors the UI tabs on /campaigns):
- "All" tab: omit both → API returns everything.
- "Active" tab: status="Launched", experiment_statuses="Active,WithoutSpend" (launched campaigns with live or not-yet-spending experiments).
- "Paused" tab: status="Launched", experiment_statuses="Paused" (launched campaigns whose experiments are paused).
- "Draft" tab: status="Draft" (campaign hasn't been launched yet — experiment status doesn't apply).
- "Finished" tab: status="Finished".
SORTING:
- sort_by: createdDate (default), startDate, endDate, name, budget, spent, leads, cpl, cpc, ctr, impressions, clicks, status
- sort_order: asc | desc (default: desc)
PAGINATION:
- page: 0-based page index (default 0)
- size: results per page (default 25; the UI campaign list fetches 25–50)
RESPONSE SHAPE:
{
"totalElements": 435,
"totalPages": 18,
"data": [
{
"id": 173290,
"accountId": 1455,
"name": "2026_Q2_NA_Builder_Content_...",
"createdDate": "2026-01-15T12:00:00Z",
"visibility": "VISIBLE" | "ARCHIVED",
"budget": 25,
"startDate": "...",
"endDate": "...",
"status": "Launched" | "Draft" | ...,
"activeExperiments": 9, "pausedExperiments": 0, "totalExperiments": 9,
"leads": 0, "spent": 0, "impressions": 48, "clicks": 0,
"cpc": 0, "cpl": 0, "ctr": 0.0,
"goal": "CTR" | "CPL",
"campaignGroup": "TOF - AO - Social - Billing - BA",
"tags": [...]
}, ...
]
}
WORKFLOW (UI-style): list_wizard_campaigns(page=0, size=25) → render list → user clicks campaign → search_campaigns_by_names / get_campaign_by_wizard_id for details.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional: server-side name substring filter. | |
| page | No | 0-based page index. Default: 0 | |
| size | No | Results per page. Default: 25 | |
| status | No | Campaign-level status filter. Comma-separated subset of Draft, Launched, Finished. Omit to include all three. Combine with experiment_statuses to mirror the UI tabs (e.g. Active tab = status=Launched + experiment_statuses=Active,WithoutSpend). | |
| sort_by | No | Field to sort by. Default: createdDate | |
| sort_order | No | Sort order. Default: desc | |
| visibility | No | Optional: filter by campaign visibility. Omit to include all. | |
| experiment_statuses | No | Experiment-level status filter. Comma-separated subset of Active, WithoutSpend, Paused, Completed, Failed. Omit to include all five. |