Quick and easy to setup solution for testing webhooks, using Golang and ngrok.

This project can be used via Docker, without the need of any Go tools installed to make the build for your host OS.

To run the webhook application, execute the following command. The ngrok token can be retrieved from your Ngrok Dashboard. This application will not keep any copies nor forward the provided token. It's usage is entirely local.

NGROK_TOKEN='YOUR NGROK TOKEN HERE' make run

The webhook URL will be the domain exhibited after webhook initialization + "/webhook", e.g. http://xxxx-xxx-xxx-xx-xx-xxx.ngrok.xyz/webhook. All received requests will be logged to history.log. This file's contents are displayed by the docker container logs for convenience.

To clean the log file and docker image generated by this workflow, run the following command:

make clean

If you want more flexibility and/or access to the application flags, run the following command to install it to your PATH (note that this method requires the Go toolkit to be installed and available on your CLI):

make local-install

To remove the installed app from your PATH, run the following command:

make local-clean

Available flags are listed below:

Exemples:

Setting custom port and output log file path:

simple-webhook -p 5000 -l history.log

Setting custom endpoint route and opting for ngrok execution

simple-webhook -e /webhook -t -a xxxxxxxyyyyzzzzzzz