Wrapped token withdrawal

Sent when a wrapped token withdrawal completes. The payload carries the wrapped and unwrapped amounts, the destination wallet address, and the transfer transaction key.

WEBHOOK custodyWrappedTokenWithdrawal

Example

{
  "subscriptionId": "00000000-0000-4000-8000-000000000001",
  "notificationId": "c4a80f16-7b92-4de3-a105-6f8c2b9d3e71",
  "notificationType": "custody.wrappedTokenWithdrawal",
  "notification": {
    "id": "f61d3e08-4c27-49ba-8e15-9d0a7b2c6f38",
    "fromAmount": {
      "amount": "250.00",
      "currency": "wcirBTC"
    },
    "toAmount": {
      "amount": "250.00",
      "currency": "cirBTC"
    },
    "transferWalletAddress": "0x7a3f9c1e5b8d2046af7c3e91b5d804a2f6c9e1b7",
    "transferTxUrlKey": "0x1d5e8b3a9f7c204e6b1d8a3f5c9e07b2d4a6f8c1e3b5d7a9f0c2e4b6d8a1f3c5e",
    "createDate": "2026-08-25T19:24:37.116Z",
    "nickname": "Example workspace"
  },
  "timestamp": "2026-08-25T19:24:37.402881559Z",
  "version": 2
}

Body

application/json

The envelope every v2 webhook notification arrives in. The product-specific fields live in notification.

subscriptionId · string<uuid> · required

ID of the webhook subscription that produced this notification.

notificationId · string<uuid> · required

Unique ID for this event. Stable across retries of the same delivery, so use it to deduplicate.

notificationType · enum<string> · required

The type of notification.

Available options: custody.wrappedTokenWithdrawal

notification · any · required

The event payload. The schema of this object depends on notificationType.

timestamp · string<date-time> · required

When the notification was produced.

version · integer · required

The version of the notification schema. Always 2.

Response

200

Webhook received successfully