Documentation Menu

Replay Failed Webhooks from the Terminal

The Iteration Loop Bottleneck

When developing an integration, your local server will crash. You will encounter TypeError exceptions parsing nested JSON, and you will return 500s. The traditional approach requires you to go back to Shopify/Stripe, create a new mock order, and wait for the event to fire just to test your 1-line code fix. This destroys developer velocity.

Hookmetry stores the exact raw payload and headers of every webhook that hits your endpoint. You can use the CLI to instantly replay past events directly to your local server, achieving sub-second iteration loops.

Step 1: Identify the Dropped Payload

List your recent webhook logs to find the log_id of the event that crashed your server.

hookmetry logs

Step 2: Replay the Event

Use the trigger command to fetch the exact raw byte-stream and POST it to your local target.

hookmetry trigger log_98765xyz --target localhost:3000/webhook

Because Hookmetry replays the exact raw bytes and identical headers, your local HMAC signature validation will pass exactly as if the original provider had sent it again.

Was this page helpful?

Your feedback helps us improve the docs.