# Webhook

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

> The `hanzo webhook` commands.

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

How your app hears about events: register an endpoint, pick the events, get each one delivered and signed.

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

```bash
hanzo webhook 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 webhook create`          | Registers a new webhook subscription for the caller's org and answers 201 with the endpoint INCLUDING its freshly minted signing secret.                                            |
| `hanzo webhook deliveries <id>` | Returns one endpoint's per-attempt delivery log, newest first — the record of what was sent, what the subscriber answered, and how long it took.                                    |
| `hanzo webhook get <id>`        | Returns one of the caller org's webhook endpoints with its 7-day delivery and failure counts, signing secret redacted.                                                              |
| `hanzo webhook list`            | Returns every webhook endpoint the caller's org has registered, newest first, each with its 7-day delivery and failure counts.                                                      |
| `hanzo webhook rm <id>`         | Removes one of the caller org's webhook endpoints and answers 204 with no body.                                                                                                     |
| `hanzo webhook secret <id>`     | Mints a NEW HMAC signing secret for the endpoint and answers the endpoint WITH it — the only other response besides create that ever carries a secret.                              |
| `hanzo webhook set <id>`        | Replaces the editable fields of one of the caller org's endpoints — url, events, status and description — and answers the stored row with its secret redacted.                      |
| `hanzo webhook test <id>`       | Sends ONE signed test event to the endpoint right now and answers the outcome inline, so the console can show whether the subscriber is reachable without waiting for real traffic. |