Outbound Commands

Commands for managing outbound webhooks — sending webhooks from your application to external endpoints.

Info

Outbound commands are part of the Send Webhooks feature. They're available in the same CLI for convenience.

Applications

Manage outbound webhook applications.

outbound applications list

List all outbound applications.

hookbase outbound applications list
hookbase outbound apps ls --json

Aliases: outbound apps list, outbound apps ls

outbound applications create

Create a new outbound application.

# Interactive
hookbase outbound applications create
 
# With options
hookbase outbound applications create \
  --name "My SaaS App" \
  --uid "my-saas-app"

Options:

Option	Description
`-n, --name <name>`	Application name
`-u, --uid <uid>`	Unique identifier
`-y, --yes`	Skip confirmation

outbound applications get

Show application details.

hookbase outbound applications get app_abc123
hookbase outbound apps show app_abc123 --json

Aliases: outbound apps get, outbound apps show

outbound applications update

Update an application.

hookbase outbound applications update app_abc123 --name "Updated Name"

Options:

Option	Description
`-n, --name <name>`	New name
`-r, --rate-limit <number>`	Rate limit per second

outbound applications delete

Delete an application.

hookbase outbound applications delete app_abc123
hookbase outbound apps rm app_abc123 --yes

Aliases: outbound apps delete, outbound apps rm

Endpoints

Manage webhook endpoints within an application.

outbound endpoints list

List endpoints for an application.

hookbase outbound endpoints list --app app_abc123
hookbase outbound endpoints ls --app app_abc123 --json

Options:

Option	Description
`--app <appId>`	Application ID (required)

outbound endpoints create

Create a new endpoint.

hookbase outbound endpoints create \
  --app app_abc123 \
  --url "https://customer.example.com/webhooks" \
  --events "order.created,order.updated"

Options:

Option	Description
`--app <appId>`	Application ID (required)
`-u, --url <url>`	Endpoint URL (required)
`-e, --events <events>`	Comma-separated event types to subscribe to
`-n, --name <name>`	Endpoint name
`-y, --yes`	Skip confirmation

outbound endpoints get

Show endpoint details.

hookbase outbound endpoints get ep_abc123 --app app_abc123

outbound endpoints update

Update an endpoint.

hookbase outbound endpoints update ep_abc123 \
  --app app_abc123 \
  --url "https://new-url.example.com/webhooks"

outbound endpoints delete

Delete an endpoint.

hookbase outbound endpoints delete ep_abc123 --app app_abc123 --yes

outbound endpoints test

Send a test event to an endpoint.

hookbase outbound endpoints test ep_abc123 --app app_abc123
hookbase outbound endpoints test ep_abc123 --app app_abc123 --event "order.created"

Options:

Option	Description
`--app <appId>`	Application ID (required)
`--event <type>`	Event type for test (default: `test.event`)

outbound endpoints rotate-secret

Rotate the signing secret for an endpoint.

hookbase outbound endpoints rotate-secret ep_abc123 --app app_abc123

Messages

View and manage outbound webhook messages (delivery attempts).

outbound messages list

List recent messages for an application.

hookbase outbound messages list --app app_abc123
hookbase outbound messages ls --app app_abc123 --status failed

Options:

Option	Description
`--app <appId>`	Application ID (required)
`--status <status>`	Filter: `sent`, `failed`, `pending`
`--endpoint <epId>`	Filter by endpoint
`-l, --limit <number>`	Number of messages (default: 50)

outbound messages get

Show message details including delivery attempts.

hookbase outbound messages get msg_abc123 --app app_abc123

outbound messages retry

Retry a failed message.

hookbase outbound messages retry msg_abc123 --app app_abc123

Dead Letter Queue

Manage failed outbound messages.

outbound dlq list

List dead letter queue items.

hookbase outbound dlq list --app app_abc123
hookbase outbound dlq ls --app app_abc123 --json

Options:

Option	Description
`--app <appId>`	Application ID (required)
`-l, --limit <number>`	Number of items (default: 50)

outbound dlq get

Show DLQ item details.

hookbase outbound dlq get dlq_abc123 --app app_abc123

outbound dlq retry

Retry a single DLQ item.

hookbase outbound dlq retry dlq_abc123 --app app_abc123

outbound dlq bulk-retry

Retry multiple DLQ items.

hookbase outbound dlq bulk-retry --app app_abc123
hookbase outbound dlq bulk-retry --app app_abc123 --limit 100 --yes

Options:

Option	Description
`--app <appId>`	Application ID (required)
`-l, --limit <number>`	Max items to retry (default: 50)
`-y, --yes`	Skip confirmation

outbound dlq delete

Delete a DLQ item (permanently discard).

hookbase outbound dlq delete dlq_abc123 --app app_abc123 --yes

Send

Send a webhook message directly from the CLI.

hookbase outbound send \
  --app app_abc123 \
  --event "order.created" \
  --payload '{"order_id": "123", "amount": 4999}'

Options:

Option	Description
`--app <appId>`	Application ID (required)
`--event <type>`	Event type (required)
`--payload <json>`	JSON payload
`--payload-file <path>`	Path to JSON payload file
`--endpoint <epId>`	Send to specific endpoint only

Examples

# Send from a file
hookbase outbound send \
  --app app_abc123 \
  --event "invoice.paid" \
  --payload-file ./invoice-event.json
 
# Send to a specific endpoint
hookbase outbound send \
  --app app_abc123 \
  --event "user.created" \
  --payload '{"user_id": "usr_123"}' \
  --endpoint ep_xyz789

Send Webhooks — Getting Started — Setup guide
Send Webhooks — API Reference — REST API docs
CLI Commands — Receive webhook CLI commands