Transfer state change

{ "subscriptionId": "00000000-0000-4000-8000-000000000001", "notificationId": "11111111-1111-4111-8111-111111111101", "notificationType": "custody.transfer", "notification": { "id": "22222222-2222-4222-8222-222222222201", "source": { "type": "wallet", "id": "1000000001" }, "destination": { "type": "wallet", "id": "1000000002" }, "amount": { "amount": "100.00", "currency": "USD" }, "status": "complete", "createDate": "2026-08-25T19:17:02.027Z", "nickname": "Example workspace", "walletDescription": "Example account" }, "timestamp": "2026-08-25T19:17:02.429598683Z", "version": 2 }

Body

application/json

A webhook payload

subscriptionId

string<uuid>

ID of the webhook subscription that produced this notification.

notificationId

string<uuid>

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

notificationType

enum<string>

The type of notification.

Available options:

custody.transfer

notification

any

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

timestamp

string<date-time>

When the notification was produced.

version

integer

The version of the notification schema. Always 2.

Response

200

Webhook received successfully