🚧
Deprecation notice
Webhooks v1 will be deprecated on June 15th, 2026. Please use the Developer Center in the Fireblocks Console to upgrade to Webhooks V2, which offers improved reliability, performance, and observability.

This page describes all events relating to internal, external, and contract whitelisted wallets that produce webhook notifications, and their associated data objects.

The type parameter is automatically set to the description name for the data objects below.

Asset added to internal wallet

Notification is sent when an asset is added to an internal wallet.

Parameter	Type	Description
type	string	INTERNAL_WALLET_ASSET_ADDED
tenantId	string	Unique ID of your Fireblocks workspace
timestamp	number	Timestamp in milliseconds
data	WalletAssetWebhook	Internal wallet details

Asset removed from internal wallet

Notification is sent when an asset is removed from an internal wallet.

Parameter	Type	Description
type	string	INTERNAL_WALLET_ASSET_REMOVED
tenantId	string	Unique ID of your Fireblocks workspace
timestamp	number	Timestamp in milliseconds
data	WalletAssetWebhook	Internal wallet details

Asset added to external wallet

Notification is sent when an asset is added to an external wallet.

Parameter	Type	Description
type	string	EXTERNAL_WALLET_ASSET_ADDED
tenantId	string	Unique ID of your Fireblocks workspace
timestamp	number	Timestamp in milliseconds
data	WalletAssetWebhook	External wallet details

Asset removed from external wallet

Notification is sent when an asset is removed from an external wallet.

Parameter	Type	Description
type	string	EXTERNAL_WALLET_ASSET_REMOVED
tenantId	string	Unique ID of your Fireblocks workspace
timestamp	number	Timestamp in milliseconds
data	WalletAssetWebhook	External wallet details

Asset added to contract wallet

Notification is sent when an asset is added to a contract wallet.

Parameter	Type	Description
type	string	CONTRACT_WALLET_ASSET_ADDED
tenantId	string	Unique ID of your Fireblocks workspace
timestamp	number	Timestamp in milliseconds
data	WalletAssetWebhook	Contract wallet details

Asset removed from contract wallet

Notification is sent when an asset is removed from a contract wallet.

Parameter	Type	Description
type	string	CONTRACT_WALLET_ASSET_REMOVED
tenantId	string	Unique ID of your Fireblocks workspace
timestamp	number	Timestamp in milliseconds
data	WalletAssetWebhook	Contract wallet details

WalletAssetWebhook

Parameter	Type	Description
assetId	string	The wallet's asset
walletId	string	The ID of the wallet
walletName	string	The name of the wallet
address	string	The address of the wallet
tag	string	Destination address tag for Ripple; destination memo for Cosmos, EOS, Luna, Luna Classic, NEM, Stellar, Hedera, & DigitalBits; destination note for Algorand; bank transfer description for fiat providers.
activationTime	number	The time the wallet will be activated, if wallet activation is postponed according to your workspace definition