> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crown-brlv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks Setup

> Configure webhooks to receive real-time notifications about events in your Crown account

## Access Management Console

Navigate to the **Manage Users** section in your Crown dashboard to begin setting up webhooks.

## Register Your Webhook URL

1. Enter your webhook endpoint URL in the **Webhook URL** field (e.g., `https://your-app.com/webhooks`)
2. Click **Register Webhook**

Your webhook will be immediately active and begin receiving events.

## Webhook Events

Your registered endpoint will receive POST requests for the following events:

* **deposit-processed** - When a deposit has been successfully processed
* **order-completed** - When a currency conversion order completes
* **token-transfer-completed** - When a token transfer finishes
* **withdraw-completed** - When a withdrawal is processed
* **claim-completed** - When a yield claim is completed

See the [Webhooks API Reference](/api-reference/webhooks/deposit-processed) for detailed payload schemas.

## Managing Webhooks

You can manage your registered webhooks directly from the dashboard:

* **Pause** - Temporarily stop receiving webhook events without deleting the registration
* **Remove** - Permanently delete the webhook registration

<Warning>
  Ensure your webhook endpoint returns a `200 OK` response quickly (within 5 seconds) to acknowledge receipt. Failed webhooks may be retried automatically.
</Warning>

## Webhook Security

All webhook requests include an `X-Crown-Signature` header containing an HMAC-SHA256 signature. Verify this signature to ensure the request is authentic. See the [API Reference](/api-reference/introduction) for verification examples.