🧪 Webhook Tester

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.

---

✨ Features

• 📩 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
• 🔐 API to manage webhooks
• 📚 Swagger API documentation
• 🧪 Built for testing, mocking, and debugging external integrations

---

🏃‍♂️ Getting Started (Manual)

1. Clone & Configure

git clone https://github.com/muliswilliam/webhook-tester
cd webhook-tester
cp .env.example .env

2. Generate AUTH_SECRET

Auth secret must be 32 bytes. Generate one with:

openssl rand -base64 32

Paste it into your .env file.

3. Run Locally

go run cmd/main.go

Visit: http://localhost:3000

---

🐳 Running with Docker (Recommended)

1. Set environment variables & Start Services

cp .env.example .env
make up

This builds the Docker image and starts all services using docker-compose.

2. View Logs for a Specific Service

make logs SERVICE=app
make logs SERVICE=db

3. Restart a Specific Service

make restart SERVICE=app
make restart SERVICE=db

4. Stop All Services

make down

5. List Available Services

make services

6. 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:

http://localhost:3000/docs

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