Webhooks
Using webhooks provides a mechanism to be sent consensus responses from your client without having to wait for consensus. Currently in development.
Last updated
Was this helpful?
Using webhooks provides a mechanism to be sent consensus responses from your client without having to wait for consensus. Currently in development.
Last updated
Was this helpful?
In your Vercel deployment set WEBHOOK_URL to the POST route that you wish to send all messages and redeploy your API.
The concern of webhooks combined with trust is proving that the message came from the correct source.
In the request there will be a header including an x-signature this will be a HMAC hash of the body and the API_SECRET_KEY using the SHA256 algorithm.
To trust the source of the message you'll need to match the signature by creating a hash of the body and API_SECRET_KEY in your server and comparing.
We provide an example webhook implementation that you can copy for your needs, this is found in the and the for inspiration.
The route of the webhook for the project is /api/webhook.
To conform your webhook to our standards and testing mechanism the behaviour is as follows.
The webhook will only respond to a POST request
The webhook requires a x-signature in its header, this is a HMAC SHA256 signature.
The webhook is a valid signature of the entire payload body.
If the incorrect HTTP method is used to request the webhook the status code will be 405 (Method Not Allowed).
If the x-signature cannot be verified with the payload a status code 400 (Bad Request) will be returned.