# Ad

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

> The `hanzo ad` commands.

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

Your paid ad campaigns, launched and paused from one place.

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

```bash
hanzo ad campaigns 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 ad summary` | Rolls the caller org's ad campaigns up into four numbers: how many campaigns exist, how many are active, and the summed budget and spend across all of them. |

### Campaigns

| Command                          | What it does                                                                                                     |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `hanzo ad campaigns create`      | Registers a new ad campaign for the caller's org and answers 201 with the stored row.                            |
| `hanzo ad campaigns get <id>`    | Returns one of the caller org's campaigns.                                                                       |
| `hanzo ad campaigns launch <id>` | Run one of your stored campaigns on its ad network                                                               |
| `hanzo ad campaigns list`        | Returns the caller org's ad campaigns, most recently updated first, optionally narrowed to one lifecycle status. |
| `hanzo ad campaigns rm <id>`     | Removes one of the caller org's campaigns and answers 204 with no body.                                          |
| `hanzo ad campaigns set <id>`    | Replaces the user-owned fields of one of the caller org's campaigns and answers the stored row.                  |