Tutorials 7 min read

HookWatch CLI: Manage Webhooks from Your Terminal

Learn how to manage webhook endpoints, inspect events, configure cron jobs, and monitor delivery—all from the command line with the HookWatch CLI.

HookWatch Team

February 10, 2026

The HookWatch CLI brings your entire webhook infrastructure to the terminal. Whether you're debugging a failed delivery, spinning up a new endpoint, or automating cron-based health checks, the CLI gives you full control without opening a browser.

Installation

Install the HookWatch CLI with a single command:

Bash

# macOS / Linux
curl -fsSL https://hookwatch.dev/install.sh | bash

# Or with Go
go install github.com/hookwatch-dev/cli@latest

Verify the installation:

Bash

hookwatch --version
# hookwatch v0.4.2

Authentication

Bash

hookwatch login
# Opens browser for authentication
# ✓ Logged in as you@example.com
# ✓ API key created and stored

The CLI stores your API key locally so you stay authenticated across sessions.

Managing Endpoints

List Your Endpoints

Bash

hookwatch endpoints list

Code

ID          SLUG              STATUS    EVENTS    CREATED
ep_abc123   payment-webhook   active    1,247     2026-01-15
ep_def456   github-ci         active    8,932     2025-12-01
ep_ghi789   slack-alerts      paused    312       2026-02-01

Create a New Endpoint

Bash

hookwatch endpoints create \
  --name "Order Notifications" \
  --destination "https://api.myapp.com/webhooks/orders" \
  --retry-count 5 \
  --retry-interval 30

Get Endpoint Details

Bash

hookwatch endpoints get ep_abc123

Code

Endpoint: payment-webhook
Status:   active
URL:      https://hook.hookwatch.dev/wh/payment-webhook
Dest:     https://api.myapp.com/webhooks/payments
Retries:  3 attempts, 60s interval
Events:   1,247 total (1,241 delivered, 4 retrying, 2 failed)
Created:  2026-01-15T10:30:00Z

Inspecting Events

View Recent Events

Bash

hookwatch events list --endpoint ep_abc123 --limit 10

Code

ID            STATUS      METHOD   SIZE     RECEIVED
evt_001       delivered   POST     1.2KB    2 min ago
evt_002       delivered   POST     856B     5 min ago
evt_003       retrying    POST     2.1KB    8 min ago
evt_004       delivered   POST     1.1KB    12 min ago

Inspect a Specific Event

Bash

hookwatch events get evt_003

Code

Event: evt_003
Status:    retrying (attempt 2/3)
Endpoint:  payment-webhook
Method:    POST
Size:      2.1KB
Received:  2026-02-10T14:23:11Z

Headers:
  Content-Type: application/json
  X-Stripe-Signature: t=1707...

Response:
  Status: 503 Service Unavailable
  Time:   2.3s

Next retry: in 45 seconds

Managing Alerts

Stay informed about delivery failures:

Bash

# List active alerts
hookwatch alerts list

# View alert details
hookwatch alerts get alt_xyz789

Code

ID          ENDPOINT          TYPE              TRIGGERED
alt_xyz789  payment-webhook   consecutive_fail  2026-02-10 14:25
alt_abc123  github-ci         high_error_rate   2026-02-09 09:12

Cron Jobs

The CLI includes a built-in cron scheduler for running recurring webhook tasks:

List Cron Jobs

Bash

hookwatch cron list

Code

ID          NAME              SCHEDULE       STATUS    LAST RUN
cron_001    health-check      */5 * * * *    active    2 min ago
cron_002    daily-report      0 9 * * *      active    14 hours ago
cron_003    data-sync         0 */2 * * *    paused    3 days ago

Run a Job Manually

Bash

hookwatch cron run cron_001
# ✓ Execution queued (exec_abc123)
# ✓ Status: success (completed in 1.2s)

Start the Cron Service

Run the cron daemon to automatically execute scheduled jobs:

Bash

hookwatch cron service
# ✓ Cron service started
# Polling for pending executions...
# [14:30:00] Executing health-check (cron_001)
# [14:30:01] ✓ health-check completed (200 OK)

API Key Management

Bash

# List your API keys
hookwatch apikeys list

# Create a new key
hookwatch apikeys create --name "CI/CD Pipeline"

# Revoke a key
hookwatch apikeys revoke key_abc123

Tips and Tricks

Pipe Output to Other Tools

The CLI output works well with standard Unix tools:

Bash

# Count failed events today
hookwatch events list --status failed | wc -l

# Watch events in real-time
watch -n 5 hookwatch events list --limit 5

# Export endpoint config
hookwatch endpoints get ep_abc123 --format json > endpoint-backup.json

Use in CI/CD Scripts

Bash

#!/bin/bash
# Create endpoint for preview deployment
ENDPOINT=$(hookwatch endpoints create \
  --name "preview-${PR_NUMBER}" \
  --destination "https://preview-${PR_NUMBER}.myapp.com/webhooks" \
  --format json | jq -r '.slug')

echo "Webhook URL: https://hook.hookwatch.dev/wh/${ENDPOINT}"

Getting Started

The HookWatch CLI connects to the same cloud infrastructure as the dashboard. Everything you do in the terminal is instantly visible in the web UI—and vice versa.

Install the CLI, log in, and start managing your webhooks from where you're most productive.

Tags: cliterminaldevopsautomationwebhooks

Share this article

Twitter LinkedIn

HookWatch CLI: Manage Webhooks from Your Terminal

Installation

Authentication

Managing Endpoints

List Your Endpoints

Create a New Endpoint

Get Endpoint Details

Inspecting Events

View Recent Events

Inspect a Specific Event

Managing Alerts

Cron Jobs

List Cron Jobs

Run a Job Manually

Start the Cron Service

API Key Management

Tips and Tricks

Pipe Output to Other Tools

Use in CI/CD Scripts

Getting Started

Share this article

Related Posts

Scheduled Webhooks with Cron Jobs: Automate Recurring Tasks

How to Migrate from Polling to Webhooks: A Step-by-Step Guide

Building a Real-Time Order Dashboard with Webhooks

Ready to try HookWatch?