Introduction
Last updated
Was this helpful?
Last updated
Was this helpful?
Webhook Relay is an API driven, secure tunnelling solution. Our two main services are:
- secure, unidirectional by default with optional request/response transformation.
- fast tunnels for direct access to any HTTP service. This is ideal for accessing internal services and demoing websites.
Webhook forwarding is by default a uni-directional (“one way”) way to send webhooks to other internal and public destinations.
Key facts:
Unidirectional by default, but you can enable it to wait for the response.
Single received webhook can be forwarded to multiple destinations.
You can use webhook forwarding when:
Your requirement is primarily “fire and forget“.
You need to forward a single webhook to multiple destinations (fan-out).
You need to transform webhook, for example Docker push webhook into a Slack message.
Domain name (configurable in all paid plans).
Static response code, headers and body.
Dynamic response coming from any destination (must respond within 10 seconds).
Main options for output configuration:
Destination (where to forward).
Path lock - whether to dynamically append URL paths (xyz.hooks.webhookrelay.com/foo/bar -> localhost:8080/foo/bar)
Tunnels can be used to open bidirectional pathways that allow remote access to the server.
You can use to filter and modify requests/responses.
You need to forward webhooks to internal destinations ().
Inputs represent your public endpoints. These are the unique for instance, https://xyz.hooks.webhookrelay.com. Each input have several configuration options:
Each input can have an attached which can modify response and request.
Outputs define your destination, where webhooks will be sent. These destinations can either be an HTTP server running on your local machine () or a public server such as .
Attached to execute on a webhook.
are a grouping mechanism in Webhook Relay for Inputs and Outputs.
You can create, view and manage your tunnels here: .
Access tokens are used to authenticate Webhook Relay agents and any other API requests. You can provision a key and secret pair here: .
