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.

Browse all webhook events for the full listing across Dynamic products.

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.

Transaction events

Report what happened to a transaction Dynamic sent for a user, including the ones that never land. Available today for gas-sponsored EVM transactions.

wallet.transaction.broadcasting · object

Occurs when a transaction is handed to the broadcaster. A transaction hash may not exist yet.

wallet.transaction.confirming · object

Occurs once the transaction is on the chain and waiting to be confirmed.

wallet.transaction.completed · object

Occurs when the transaction lands and is confirmed. Final.

wallet.transaction.reverted · object

Occurs when the transaction lands and the contract rejects it. Final, and carries a reason code.

wallet.transaction.failed · object

Occurs when the transaction never reaches the chain and never will. Final, and carries a reason code.

Exactly one of completed, reverted and failed arrives per transaction. See Transaction events for the reason codes and how these sit alongside on-chain activity.

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.