> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet events

This page covers all wallet events that can trigger webhook notifications, and their associated data objects for the Webhooks v2 service.

## Wallet event types

To receive a specific event, include its **eventType** in the webhook's [notification object](https://developers.fireblocks.com/reference/webhooks-structures-notificationstructure.md).

| Event type | Data object returned |
| - | - |
| vault\_account.created | [VaultAccount](https://developers.fireblocks.com/reference/vault-objects.md#vaultaccount) |
| vault\_account.asset.added | [VaultAsset](https://developers.fireblocks.com/reference/vault-objects.md#vaultasset) |
| vault\_account.asset.balance\_updated | [VaultAccountBalanceUpdate](https://developers.fireblocks.com/reference/vault-objects.md#vaultaccountbalanceupdate) |
| vault\_account.nft.balance\_updated | [BalanceObject](#balanceobject) |
| vault\_account.bulk\_create\_job\_started | [BulkJobStarted](#bulkjobstarted) |
| vault\_account.bulk\_create\_job\_ended | [BulkJobEnded](#bulkjobended) |
| vault\_account.asset.bulk\_add\_job\_started | [BulkJobStarted](#bulkjobstarted) |
| vault\_account.asset.bulk\_add\_job\_ended | [BulkJobEnded](#bulkjobended) |

## Bulk operation events

These events track the lifecycle of asynchronous bulk operations: bulk vault account creation (`vault_account.bulk_create_*`) and bulk deposit address creation (`vault_account.asset.bulk_add_*`). A `_job_started` event is sent when the job is submitted, and a `_job_ended` event is sent when the job reaches a terminal state. Use the `jobId` to query the job status endpoint for per-item results.

## Data objects

### BulkJobStarted

| Parameter | Type | Description |
| - | - | - |
| jobId | string | Unique identifier (UUID) of the bulk operation job. Use it to query the job status endpoint. |

### BulkJobEnded

| Parameter | Type | Description |
| - | - | - |
| jobId | string | Unique identifier (UUID) of the bulk operation job. Use it to query the job status endpoint. |
| status | string | Terminal status of the job. One of `COMPLETED` or `FAILED`. |
| errorMessage | string | **\[Optional]** Error description, present when `status` is `FAILED`. |

### BalanceObject

| Name | Type | Description |
| - | - | - |
| owner | [OwnerObject](#ownerobject) | The owner of the NFT with the changed balance. |
| outgoing | boolean \[Optional] | Indicates whether the transfer is outgoing from the vault. |
| amount | string \[Optional] | The amount of the NFT transferred in the balance change. |
| total | string | The token balance. Represented as a decimal string. |
| blockNumber | number | The block number of the NFT when its token balance was last queried. |

### OwnerObject

| Name | Type | Description |
| - | - | - |
| type | PeerType | The source of the transfer (e.g., VAULT\_ACCOUNT, INTERNAL\_WALLET). |
| accountId | string | The vault account ID. |
| walletId | string \[Optional] | The Non-Custodial Wallet (NCW) ID. |
| address | string | The owner's wallet address (i.e., the vault account ID or the NCW ID). |
