> For the complete documentation index, see [llms.txt](https://learn.layerswap.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.layerswap.io/api/api-integration/webhooks.md).

# Webhooks

### Setup

Layerswap provides a webhook configuration functionality so that Partners can receive notifications on any swap status change. Webhooks can be set up per partner application. In order to configure a webhook the following steps must be performed:

* Login to <https://layerswap.io/dashboard>
* Select the organization/app
* From left pane select Webhooks, then provide the URL where the webhook should be received and click Create Webhook
* The newly created webhook should appear under the app
* Copy the webhook secret for future verification

<figure><img src="/files/FIBEQ4KzknZEa0pDcE9c" alt=""><figcaption><p>Webhook configuraiton</p></figcaption></figure>

### Verification

Layerswaps uses Svix for Webhook Management. In order to verify an incoming webhook from Svix please refer to <https://docs.svix.com/receiving/verifying-payloads/how>. Use the webhook secret from the dashboard as a Svix secret.

For the structure of the swap notification, please refer to the [Swap Data object](/api/data/object-types.md). Please note that the complete information webhook will be sent only when the swap status is completed. For other statuses, notification will include a subset of this information (whatever is available at that time).