Authentication

Webhook Relay supports authentication on public endpoints and can also send authentication details to the destinations.

Input endpoint authentication

By default webhook endpoints accept incoming requests without authentication. To enable authentication on all public endpoints that belong to a bucket, go to settings:

Then, you can either select "basic" or "token" authentication methods.

Basic authentication

With basic authentication you will need to specify username and password:

Basic authentication for bucket endpoints

Trying to call bucket's endpoint without authentication will give us an "Authorized" error:

$ curl https://hqzxx4bpayrk4sdrfifte6.hooks.webhookrelay.com
Unauthorized

The endpoint now expects a request to have 'Authorization: Basic <base64 encoded username:password>' header. Tools like curl can help authenticate:

curl \
--user test-username:test-password \
https://hqzxx4bpayrk4sdrfifte6.hooks.webhookrelay.com

Bearer (token) authentication

To use bearer token authentication, select 'token' from the authentication menu:

enabling token authentication

In this case, to successfully send webhooks, you will need to set 'Authorization: Bearer <your token>' header:

curl \
-H 'Authorization: Bearer very-secret' \
https://hqzxx4bpayrk4sdrfifte6.hooks.webhookrelay.com