Hanzo AI

Webhook

The `hanzo webhook` commands.

Also for this capability: API · CLI · MCP · SDKs

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

API reference →

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.

CommandWhat it does
hanzo webhook createRegisters a new webhook subscription for the caller's org and answers 201 with the endpoint INCLUDING its freshly…
hanzo webhook listReturns every webhook endpoint the caller's org has registered, newest first, each with its 7-day delivery and failure…

deliveries

CommandWhat it does
hanzo webhook deliveries <id>Returns one endpoint's per-attempt delivery log, newest first — the record of what was sent, what the subscriber…

get

CommandWhat it does
hanzo webhook get <id>Returns one of the caller org's webhook endpoints with its 7-day delivery and failure counts, signing secret redacted.

rm

CommandWhat it does
hanzo webhook rm <id>Removes one of the caller org's webhook endpoints and answers 204 with no body.

secret

CommandWhat it does
hanzo webhook secret <id>Mints a NEW HMAC signing secret for the endpoint and answers the endpoint WITH it — the only other response besides…

set

CommandWhat it does
hanzo webhook set <id>Replaces the editable fields of one of the caller org's endpoints — url, events, status and description — and answers…

test

CommandWhat it does
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…

How is this guide?

On this page