Create a Webhook

In this section we explain how to create and use a Webhook

Webhooks allow interaction between wallets and web applications through the use of custom callbacks.

Webhooks are used to receive notifications about attestation status, connection status, presentation and message.

Set a Webhook

• Before creating a webhook linked to your wallet, you need to use a tool to receive the event message. If you don't have any tool able to handle webhook, we suggest using https://webhook-test.com/ or https://webhook.site/ for the test.

• When you click on the first link above, you land on a page where a unique webhook is automatically generated

• For a better understanding, we suggest to edit this unique webhook URL.

  • Click on Edit

  • Set a Title. For this first webhook, let's set for example "Holder"

  
• Then copy the URL: like in our example (but your own generated URL https://webhook-test.com/2b652ab07311bea8dfa30683ddaf9e30)
• You will use it in the step below

Create a webhook in your wallet

• From the web interface of your wallet, click on Settings

• In the Settings section, click on Webhooks

• Click on the button Create a webhook

• Past in the URL field, the webhook URL you have copied above

• Create a secret token

• Select all events

Select only events needed to avoid any unnecessary webhook calls. One suggestion is to create several webhooks: one webhook per specific topics (webhook for connection, webhook for attestation...)

• Then click on Create

We will use the webhook feature in the section Accept attestation, please check Create an attestation