Skip to main content

See a webhook's payload before you write the handler

Set the webhook URL to Buggregator with http-dump as the user name, for example http://http-dump@127.0.0.1:8000/webhooks/orders. Each delivery shows the full webhook payload: method, URL, headers, cookies, form data, uploaded files, and a cURL command to send it again. You see exactly what arrives before you write the handler.

Steps

1. Point the webhook at Buggregator

Buggregator takes HTTP events on port 8000, the same port as the UI. Use http-dump as the URL user name. The path is yours to choose. In Docker Compose, replace 127.0.0.1 with the Buggregator service name, for example buggregator.

dotenv
# Your app sends webhooks or callbacks to this URL during development
WEBHOOK_URL=http://http-dump@127.0.0.1:8000/webhooks/orders

2. Check it with a test request

Before you wait for a real delivery, send one yourself.

bash
curl 'http://http-dump@127.0.0.1:8000/any/path?foo=bar'

3. Or mark it with a header

If the sender cannot put a user name in the URL but can set a header, use X-Buggregator-Event instead.

bash
curl 'http://127.0.0.1:8000/any/path?foo=bar' \
  --header 'X-Buggregator-Event: http-dump'

4. Read the payload

Open http://127.0.0.1:8000. The request shows its method, full URI, query parameters, form data, headers, cookies and uploaded files, which you can download. Search finds requests by host, method or URL.

Why it works

Buggregator treats any HTTP request marked with http-dump, by user name or header, as a dump and stores it whole. A third-party service on the internet can only reach Buggregator at a public address, so a service in the cloud cannot call your laptop's 127.0.0.1. When you need the response from a real server too, use the HTTP proxy instead.

Checked on with Buggregator v2.8.0

Setup in 60 seconds

No registration. No account. Start it and point your app at it.

1

Start Buggregator

One file, installed with one command. The web UI opens on port 8000. Prefer containers? Use the Docker tab.

$ curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
$ HTTP_ADDR=127.0.0.1:8000 \
  SMTP_ADDR=127.0.0.1:1025 \
  VAR_DUMPER_ADDR=127.0.0.1:9912 \
  MONOLOG_ADDR=127.0.0.1:9913 \
  PROXY_ADDR=127.0.0.1:8080 \
  ~/.local/bin/buggregator

The script picks the file for your CPU: Intel/AMD or ARM.

One file for Linux, macOS and Windows, about 40 MB. Nothing else to install.

This run line keeps it on this computer. Without the *_ADDR settings it listens on all network interfaces →

Rather not run a script? Download the file yourself →

Runs on Windows, macOS and Linux, on Intel/AMD and ARM.

Prefer not to do it yourself? Your AI agent can set Buggregator up for you →