Embedded wallet webhooks

Events emitted for embedded (WaaS) wallets: lifecycle, signatures, on-chain activity, key share operations, and offline recovery.

Embedded wallet events fire under the wallet.* namespace. They cover the wallet lifecycle, completed signatures, confirmed on-chain activity, and key share operations.

For the shared event envelope, endpoint setup, retries, and signature verification, see Setting up webhooks and Event delivery & best practices. The current list of event types is always available from the event types endpoint.

Lifecycle events

wallet.created · object

Occurs whenever a Dynamic-powered embedded wallet is created. Is a wallet.

wallet.linked · object

Occurs whenever a wallet is linked to a user. Is a wallet.

wallet.unlinked · object

Occurs whenever a wallet is unlinked from a user. Is a wallet.

wallet.exported · object

Occurs whenever a Dynamic-powered embedded wallet is exported. Is a wallet.

wallet.transferred · object

Occurs whenever a wallet is transferred between user accounts. Is a wallet.

wallet.signature · object

Occurs whenever a WaaS wallet signature is completed. Is a wallet.

wallet.deleted is emitted when a wallet is deleted but is not selectable in the event types catalog today.

On-chain activity events

wallet.activity · object

Occurs when a confirmed transaction involves a user’s wallet. Tracks all on-chain activity across EVM, SVM, and Bitcoin networks. See on-chain events for details. Is a WalletTransaction.

wallet.activity.registered · object

Occurs when a wallet is newly registered for on-chain activity monitoring. Fired once per wallet after creation when the environment has on-chain activity tracking enabled: not on duplicates, replays, or already-registered addresses. Contains the wallet address, wallet id, and owning user id.

See On-chain events for supported networks and payload details.

Key share and recovery events

wallet.keyShares.backedUp · object

Occurs whenever a wallet’s key shares are backed up. Is a wallet.

wallet.keyShares.backedUpToExternal · object

Occurs whenever a user backs up their key share to an external location such as Google Drive. Is a wallet.

wallet.keyShares.recovered · object

Occurs whenever a wallet’s key shares are recovered. Is a wallet.

wallet.keyShares.refreshed · object

Occurs whenever a wallet’s key shares are refreshed. Is a wallet.

wallet.keyShares.reshared · object

Occurs whenever a wallet’s key shares are reshared across a new set of parties. Is a wallet.

wallet.offlineRecovery.created · object

Occurs whenever an offline recovery kit is created for a wallet.

Related events

• Delegated signing events (wallet.delegation.*) are documented under Agent webhooks.
• Screening and policy verdicts on wallet addresses (wallet.sanctions.blocked, wallet.addressScreening.*) are documented under Policy and screening webhooks.
• Exchange transfer events (user.exchangeTransfer.*) are documented under Flow webhooks.