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

# Webhook

> Automatic Notifications

This is a special feature that automatically sends notifications to your server or system whenever a certain event occurs. In our case, that means any movement of funds in wallets created via the Well Wallet.

Webhooks allow you to stay informed about all operations in real time without the need to constantly poll the API. It’s convenient, efficient, and saves resources.

## How to create ?

* A WellWallet account ([Sign up](https://t.me/wellwallet))
* An API key with appropriate permissions: Settings - Settings - API - Webhooks Managment - Create

## Permissions

WellWallet sends webhook notifications from fixed IP addresses.

Use IP allowlisting to protect your webhook endpoint and accept requests only from trusted WellWallet sources.

### Webhook Source IP Addresses

```text theme={null}
54.171.15.37/32
108.128.68.222/32
63.33.226.230/32
```

## Deposit request example

```text theme={null}
{
        "user_id": "111111111",
        "amount": "2.000000",
        "block": 83710109,
        "created": "2026-06-18T16:22:29.579Z",
        "currency": "USDT",
        "direction": "in",
        "external_id": 510391781799802,
        "hash": "f13de270d1b75220be9f62b25e1a1e5514e28a5939a58f98340a7ede56a0a3e9",
        "fee": "0",
        "recipient_wallet": "TLke79roERf8pEkKXdKLEuF2WfBsee8Wus",
        "sender_wallet": "TUgF5Ebrh419Q6ubZiB8GWvAYaa9MTGDPO",
        "status": "confirmed",
        "transaction_type": "blockchain"
    }
```

## Withdrawal request example

```text theme={null}
{
        "user_id": "2222222",
        "amount": "2",
        "block": "83710109",
        "created": "2026-06-18T16:23:23.000Z",
        "currency": "USDT",
        "direction": "out",
        "external_id": "76858081708",
        "hash": "f13de270d1b75220be9f62b25e1a1e5514e28a5939a58f98340a7ede56a0a3e9",
        "fee": "0.5",
        "recipient_wallet": "TLke79roERf8pEkKXdKLEuF2WfBsee8Wus",
        "sender_wallet": "TUgF5Ebrh419Q6ubZiB8GWvAYaa9MTGDPO",
        "status": "confirmed",
        "transaction_type": "virtual"
    }
```