hoziron webhooks

Webhook management — create HTTP endpoints that trigger agent messages.

Synopsis

hoziron webhooks <subcommand> [options]

Subcommands

SubcommandDescription
listList configured webhooks
create <agent> <url>Create a new webhook trigger
delete <id>Delete a webhook
test <id>Send a test payload

hoziron webhooks list

hoziron webhooks list [--json]

Example

$ hoziron webhooks list
ID      AGENT            URL                                        CREATED
wh-001  claims-agent     https://hooks.company.com/claims-events   2026-06-01
wh-002  monitor-agent    https://hooks.company.com/alerts           2026-06-02

hoziron webhooks create

hoziron webhooks create <agent> <url>

Example

$ hoziron webhooks create claims-agent https://hooks.company.com/claims-events
✓ Webhook created (id: wh-003)
  Agent: claims-agent
  URL: https://hooks.company.com/claims-events

hoziron webhooks delete

$ hoziron webhooks delete wh-001
✓ Webhook deleted

hoziron webhooks test

Send a test payload to verify connectivity.

$ hoziron webhooks test wh-002
Sending test payload to https://hooks.company.com/alerts...
✓ Delivered (200 OK, 45ms)

$ hoziron webhooks test wh-003
Sending test payload...
✗ Failed: connection refused (https://hooks.company.com/claims-events)

How Webhooks Work

Webhooks are outbound HTTP callbacks. When a configured event occurs, Hoziron sends a POST request to the registered URL with event data as JSON.

The agent receives the webhook payload as a message and can process it accordingly.

See Also