Quick Start Guide

Complete guide to webhooks, debugging, and real-time event monitoring with HookMetry

Quick Start

From zero to capturing your first webhook in under 5 minutes

1

Sign Up & Open the Dashboard

Go to hookmetry.com and sign up (free — no credit card). You'll land on the dashboard automatically.

2

Create Your First Endpoint

Click Endpoints → Create Endpoint and choose a validation type:

None

Capture anything. Best for exploring and testing.

Stripe

Paste your whsec_ secret. Validates Stripe-Signature.

GitHub / HMAC

Paste your webhook secret. Validates X-Hub-Signature-256.

✓ Your endpoint URL is generated instantly

https://api.hookmetry.com/webhook/ep_YOUR_ENDPOINT_ID

Your endpoint lives on api.hookmetry.com — Hookmetry's dedicated, high-availability webhook ingestion infrastructure, separate from the dashboard domain. This is intentional: the same pattern used by Stripe (api.stripe.com), GitHub (api.github.com), and Slack (hooks.slack.com) — API traffic on a dedicated domain means zero interference with the marketing site and guaranteed uptime for your webhook receiver.

3

Send Your First Webhook

Choose how you want to send your first test event:

Option A — cURL (fastest test)

curl -X POST https://api.hookmetry.com/webhook/ep_YOUR_ENDPOINT_ID \
  -H "Content-Type: application/json" \
  -d '{"event": "test.created", "data": {"id": 1, "name": "Hello Hookmetry"}}'

Option B — Connect Stripe (real data)

Stripe Dashboard → Developers → Webhooks → Add endpoint → paste your Hookmetry URL → click "Send test event"

Option C — Connect GitHub

Repository → Settings → Webhooks → Add webhook → paste your Hookmetry URL → Content type: application/json → Save → push a commit

✓

Inspect in Real-Time

Go to Webhook Logs. Your webhook appears instantly. Click it to see:

Headers

Content-Type, signature headers, User-Agent, all HTTP headers exactly as received

JSON Payload

Pretty-printed, syntax-highlighted, copyable

Signature Result

VALID ✓ or FAILED ✗ with exact error reason

Metadata

Timestamp, source IP, endpoint ID, delivery ID

What's Next?

Webhook Replay →

Send captured webhooks to your localhost for debugging

Signature Validation →

Understand HMAC verification — how it works, provider by provider

Best Practices →

Idempotency, async queues, and timeout prevention

Was this page helpful?

Your feedback helps us improve the docs.