Using Webhooks

The dexi.io webhook integration is a way of notifying your own system whenever an execution is complete - whether it failed, succeeded, or stopped.

The webhook integration also contains a payload with information about what was completed allowing you to download the results with the API and do whatever post-processing your system requires.

Setup

To set up a webhook:

1. Navigate to the App store.
2. Here you'll find the app called dexi.io webhook.
3. Select the Add button.

4. Here you'll need to name your app, and provide the URL to your system.

5. Define or generate a shared secret that will allow you to authenticate requests going to your endpoint.

Make sure they are in fact coming from us and not someone trying to exploit your system.

Testing

When you've set up your endpoint, you can select the Test configuration button which will send an example payload to your endpoint with the type test (in the JSON object).

Debugging

To debug the webhooks (e.g., see that they are being triggered when you expect them to and to see the actual payload easily) we recommend using Webhook Tester. They provide an easy setup temporary endpoint which shows you all requests made to it.