Skip to main content
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)
  • 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

54.171.15.37/32
108.128.68.222/32
63.33.226.230/32

Deposit request example

{
        "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"
    }

Withdrawal request example

{
        "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"
    }