> 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="https://2091339926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk6gvOhIkKgdK236Bl8ds%2Fuploads%2FYmDlJGzBX2jJNvVIoIyJ%2Fimage.png?alt=media&amp;token=83cbf69b-4ba3-46c9-8054-91c83ba99c06" 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).