> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.dynamic.xyz/docs/platform/console/webhooks/setup.md) and [Event delivery & best practices](https://docs.dynamic.xyz/docs/platform/console/webhooks/delivery-best-practices.md). The current list of event types is always available from the [event types endpoint](https://docs.dynamic.xyz/docs/api-reference/events/get-event-types.md).

Browse [all webhook events](https://docs.dynamic.xyz/docs/platform/console/webhooks/event-types.md) for the full listing across Dynamic products.

## Lifecycle events

**wallet.created** `object`

Occurs whenever a Dynamic-powered embedded wallet is created. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.linked** `object`

Occurs whenever a wallet is linked to a user. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.unlinked** `object`

Occurs whenever a wallet is unlinked from a user. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.exported** `object`

Occurs whenever a Dynamic-powered embedded wallet is exported. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.transferred** `object`

Occurs whenever a wallet is transferred between user accounts. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.signature** `object`

Occurs whenever a WaaS wallet signature is completed. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

> [!NOTE]
>
> `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](https://docs.dynamic.xyz/docs/embedded-wallets/on-chain-events.md) for details. Is a
[WalletTransaction.](https://docs.dynamic.xyz/docs/api-reference/schemas/WalletTransaction.md)

**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](https://docs.dynamic.xyz/docs/embedded-wallets/on-chain-events.md) 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.

Each transaction receives exactly one of `completed`, `reverted`, and `failed`. See [Transaction events](https://docs.dynamic.xyz/docs/embedded-wallets/transaction-events.md) 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.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.keyShares.backedUpToExternal** `object`

Occurs whenever a user backs up their key share to an external location such as Google Drive. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.keyShares.recovered** `object`

Occurs whenever a wallet's key shares are recovered. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.keyShares.refreshed** `object`

Occurs whenever a wallet's key shares are refreshed. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**wallet.keyShares.reshared** `object`

Occurs whenever a wallet's key shares are reshared across a new set of parties. Is a
[wallet.](https://docs.dynamic.xyz/docs/api-reference/schemas/Wallet.md)

**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](https://docs.dynamic.xyz/docs/agents/webhooks.md).
* Screening and policy verdicts on wallet addresses (`wallet.sanctions.blocked`, `wallet.addressScreening.*`) are documented under [Policy and screening webhooks](https://docs.dynamic.xyz/docs/embedded-wallets/mpc/policies/webhooks.md).
* Exchange transfer events (`user.exchangeTransfer.*`) are listed under [Exchange accounts](https://docs.dynamic.xyz/docs/platform/console/webhooks/event-types.md#exchange-accounts) in Webhook events.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.