Webhook

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

171.15.37/32
128.68.222/32
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",
        "transaction_type": "blockchain"
    }

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",
        "transaction_type": "virtual"
    }

Getting Started

API Reference

Webhook

How to create ?

Permissions

Webhook Source IP Addresses

Deposit request example

Withdrawal request example

​How to create ?

​Permissions

​Webhook Source IP Addresses

​Deposit request example

​Withdrawal request example

How to create ?

Permissions

Webhook Source IP Addresses

Deposit request example

Withdrawal request example