> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/docs/platform/dashboard/webhooks/setup) and [Event delivery & best practices](/docs/platform/dashboard/webhooks/delivery-best-practices). The current list of event types is always available from the [event types endpoint](/docs/api-reference/events/get-event-types).

## Lifecycle events

<ParamField body="wallet.created" type="object">
  Occurs whenever a Dynamic-powered embedded wallet is created. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.linked" type="object">
  Occurs whenever a wallet is linked to a user. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.unlinked" type="object">
  Occurs whenever a wallet is unlinked from a user. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.exported" type="object">
  Occurs whenever a Dynamic-powered embedded wallet is exported. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.transferred" type="object">
  Occurs whenever a wallet is transferred between user accounts. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.signature" type="object">
  Occurs whenever a WaaS wallet signature is completed. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<Note>
  `wallet.deleted` is emitted when a wallet is deleted but is not selectable in
  the event types catalog today.
</Note>

## On-chain activity events

<ParamField body="wallet.activity" type="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](/docs/embedded-wallets/on-chain-events) for details. Is a
  [WalletTransaction.](/docs/api-reference/schemas/WalletTransaction)
</ParamField>

<ParamField body="wallet.activity.registered" type="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.
</ParamField>

See [On-chain events](/docs/embedded-wallets/on-chain-events) for supported networks and payload details.

## Key share and recovery events

<ParamField body="wallet.keyShares.backedUp" type="object">
  Occurs whenever a wallet's key shares are backed up. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.keyShares.backedUpToExternal" type="object">
  Occurs whenever a user backs up their key share to an external location such as Google Drive. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.keyShares.recovered" type="object">
  Occurs whenever a wallet's key shares are recovered. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.keyShares.refreshed" type="object">
  Occurs whenever a wallet's key shares are refreshed. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.keyShares.reshared" type="object">
  Occurs whenever a wallet's key shares are reshared across a new set of parties. Is a
  [wallet.](/docs/api-reference/schemas/Wallet)
</ParamField>

<ParamField body="wallet.offlineRecovery.created" type="object">
  Occurs whenever an offline recovery kit is created for a wallet.
</ParamField>

## Related events

* Delegated signing events (`wallet.delegation.*`) are documented under [Agent webhooks](/docs/agents/webhooks).
* Screening and policy verdicts on wallet addresses (`wallet.sanctions.blocked`, `wallet.addressScreening.*`) are documented under [Policy and screening webhooks](/docs/embedded-wallets/mpc/policies/webhooks).
* Exchange transfer events (`user.exchangeTransfer.*`) are documented under [Flow webhooks](/docs/flow/webhooks).