WebHook Tester

WebHook Tester is an open-source, self-hosted application that allows users to debug and test webhooks and HTTP requests. It generates unique, random URLs to capture incoming traffic, enabling developers to inspect request data and verify how external services interact with their endpoints. This tool is particularly useful for verifying the payloads and headers sent by third-party services before implementing a production handler.

The software is deployed as a single binary or via a Docker container. It includes a built-in user interface written in ReactJS, which is compiled directly into the Go binary, meaning no additional assets are required for installation. Users access the interface through a web browser to monitor incoming requests in real time via WebSocket notifications, eliminating the need for external notification services.

Key features

• Customizable response codes, headers, and body content
• Real-time request notifications via built-in WebSocket support
• Support for memory, Redis, and filesystem storage drivers
• Integrated ngrok tunneling to expose local instances to the internet
• Binary view of recorded requests within the UI
• Multi-architecture Docker images based on scratch
• Liveness probes via a dedicated health check endpoint
• Automatic session creation for UUID-formatted request prefixes

The application is built with Go and supports three distinct storage drivers. The memory driver is used for temporary debugging where data is cleared upon shutdown, while the Redis driver retains data across restarts and is necessary when running multiple instances behind a load balancer. The filesystem driver allows data to be stored locally on the host. For WebSocket notifications, the system uses a pub/sub architecture supporting both memory and Redis drivers.

For developers needing to test webhooks from external platforms such as GitHub, GitLab, or Bitbucket, the software includes a tunnel driver that automates the creation of public URLs via ngrok. This allows the application to capture requests from the global internet without requiring manual tunnel configuration or separate software installations. The system also supports JSON and human-readable logging formats for better observability.

WebHook Tester is designed for software developers and API testers who require a private, scalable environment to inspect HTTP push notifications.