> ## 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](/reference/webhooks-structures-notificationstructure#/).

| Event type                                   | Data object returned                                                            |
| -------------------------------------------- | ------------------------------------------------------------------------------- |
| vault\_account.created                       | [VaultAccount](/reference/vault-objects#vaultaccount)                           |
| vault\_account.asset.added                   | [VaultAsset](/reference/vault-objects#vaultasset)                               |
| vault\_account.asset.balance\_updated        | [VaultAccountBalanceUpdate](/reference/vault-objects#vaultaccountbalanceupdate) |
| vault\_account.nft.balance\_updated          | [BalanceObject](/reference/nft-webhooks#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`.                        |