# Campaign

URL: https://docs.hanzo.ai/docs/cli/campaign

> The `hanzo campaign` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/campaign) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/campaign) · [SDKs](https://docs.hanzo.ai/docs/sdks)

One go-to-market push across paid, organic and email at once.

[API reference →](https://docs.hanzo.ai/docs/openapi/campaign)

```bash
hanzo campaign list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                       | What it does                                                                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo campaign create`       | Creates a campaign as a DRAFT and returns it.                                                                                                                                                                             |
| `hanzo campaign get <id>`     | Returns one campaign of the caller's org — its name, audience, creatives, channels with their per-channel launch state, schedule, budget and status.                                                                      |
| `hanzo campaign launch <id>`  | Launch a campaign across every channel it declares                                                                                                                                                                        |
| `hanzo campaign list`         | Returns the org's campaigns, newest first, optionally narrowed to one status.                                                                                                                                             |
| `hanzo campaign metrics <id>` | Returns a campaign's results over a window: the analytics funnel (impressions, clicks, conversions, revenue, visitors), the spend each channel's connector reports, and the derived growth KPIs — CTR, CVR, CAC and ROAS. |
| `hanzo campaign pause <id>`   | Pause every live channel on a campaign at its provider                                                                                                                                                                    |
| `hanzo campaign rm <id>`      | Removes one campaign of the caller's org and answers 204 with no body.                                                                                                                                                    |
| `hanzo campaign set <id>`     | Rewrites a campaign's core fields — name, audience, creatives, schedule and budget — and returns the updated campaign.                                                                                                    |
| `hanzo campaign summary`      | Returns the org's go-to-market roll-up: how many campaigns exist, how many are live, their total budget in cents, and which channel executors this deployment can actually reach.                                         |

### Channels

| Command                                  | What it does                                                                                                     |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `hanzo campaign channels create <id>`    | Adds a channel to a campaign, or REPLACES the one it already has of that kind, and returns the updated campaign. |
| `hanzo campaign channels rm <id> <kind>` | Drops one channel from a campaign and returns the updated campaign.                                              |