A lightweight, developer-friendly platform for testing and debugging webhooks - built in Go.
This project allows developers to create unique webhook endpoints, capture incoming requests, inspect headers and payloads, and optionally replay those requests.
- 📩 Receive webhooks at unique URLs
- 🔍 Inspect request payloads (headers, body, method, query params)
- 💾 Log and view webhook events in real-time
- 🛠️ Customize responses (status code, content type, payload, delay)
- 🔁 Replay events
- ↪️ Forward captured requests to your own server, and replay them to it after a fix. Each attempt is recorded as a delivery, and a request keeps its latest 50
- 🔐 API to manage webhooks
- 📚 Swagger API documentation
- 🧪 Built for testing, mocking, and debugging external integrations
git clone https://github.com/muliswilliam/webhook-tester
cd webhook-tester
cp .env.example .envAuth secret must be 32 bytes. Generate one with:
openssl rand -base64 32Paste it into your .env file.
SMTP_HOST,SMTP_PORT,SMTP_USERNAME,SMTP_PASSWORD,SMTP_FROM: SMTP server for password reset emails. WithoutSMTP_HOST, emails are written to the server log instead.METRICS_ADDR(default:9091): internal address serving Prometheus metrics at/metrics. Don't expose it publicly.FORWARD_ALLOW_PRIVATE_NETWORKS(defaultfalse): let forwarding reach private, loopback and link-local addresses, such aslocalhostor services on your own network. Keep it off on a public instance, or anyone with an account can make the server call into your internal network. While it's off, a forward URL that points at such an address is rejected when it's saved.FORWARD_TIMEOUT(default10s): how long a forward to a webhook's forward URL may take, as a Go duration (500ms,30s).FORWARD_MAX_CONCURRENT(default32): how many automatic forwards may be in flight at once. Captured requests beyond that still get captured, and their delivery records a "forwarding queue full" error.
go run cmd/main.goVisit: http://localhost:3000
- Set environment variables & Start Services
cp .env.example .env
make upThis builds the Docker image and starts all services using docker-compose.
- View Logs for a Specific Service
make logs SERVICE=app
make logs SERVICE=db- Restart a Specific Service
make restart SERVICE=app
make restart SERVICE=db- Stop All Services
make down- List Available Services
make services- View Available Commands
Run the help command to see what you can do with make:
make help📁 Project Structure
cmd/ # App entrypoint internal/ # Handlers, models, db logic, templates docs/ # Swagger documentation static/ # JS, icons, etc. db/migrations/ # SQL migrations Makefile # Dev & deployment automation Dockerfile # Production build config docker-compose.yml
📚 API Documentation
After running the app, access Swagger docs at:
API endpoints require a valid API key sent via X-API-Key header.
📌 Roadmap
- ✅ API Authentication with API keys
- ✅ Swagger Documentation
- ✅ Docker + Compose for deployment
- ⏳ Email notifications on request
- ⏳ Rate limiting and abuse protection
- ⏳ Metrics and observability (LGTM stack)
- ⏳ Export logs to JSON/CSV
- ⏳ Team/organization mode for sharing webhooks
🧠 Credits
Developed with ❤️ by William Muli