# Channel

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

> The `hanzo channel` commands.

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

One inbox for the chat apps you connect — Discord, Slack, Teams, Telegram.

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

```bash
hanzo channel 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 channel inbox`          | Returns the messages people have sent to the caller org's connected chat bots, oldest first, in the portable envelope shape every transport normalises into. |
| `hanzo channel list`           | Reports every chat channel this org can send through, and whether it can send through it right now.                                                          |
| `hanzo channel send <channel>` | Send a message from your org's bot to one chat room                                                                                                          |

### Agent

| Command                       | What it does                                                                                             |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| `hanzo channel agent get`     | Returns which agent answers the caller org's channel: the default and every room bound to another agent. |
| `hanzo channel agent replace` | Binds agents to the caller org's channel and answers the bindings as GET would.                          |

### Allowlist

| Command                           | What it does                                                                                                                                                                                                                                                                                                |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo channel allowlist get`     | Returns the caller org's access policy for one channel: whether DMs are pairing-gated, allowlisted or open, whether group rooms are open, allowlisted or disabled, the config-managed DM and group allow entries, the senders approved through PAIRING (read-only here), and the org's named access groups. |
| `hanzo channel allowlist replace` | Edits the caller org's access policy for one channel and answers the policy as GET would, so both verbs return ONE shape.                                                                                                                                                                                   |

### Pairing

| Command                         | What it does                                                                                                                                                                           |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo channel pairing approve` | Turns one pending pairing code into a standing allow entry, so that person can DM the org's bot on that channel from now on.                                                           |
| `hanzo channel pairing get`     | Returns the pairing requests waiting for the caller org to approve — one per person who messaged a connected bot on a channel whose DM policy is "pairing" and who is not allowed yet. |