> ## 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.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://developers.fireblocks.com/feedback

```json
{
  "path": "/docs/embedded-wallet-webhooks",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Webhooks

<Note>
  For Fireblocks' recommended embedded wallet solution, see [Dynamic Embedded Wallets](/docs/dynamic-embedded-wallets). The documentation below covers the legacy Embedded Wallet APIs and SDKs.
</Note>

## Transaction Created

A notification is sent when any new transaction is identified in the workspace.

| Parameter | Type                                                                     | Description                          |
| --------- | ------------------------------------------------------------------------ | ------------------------------------ |
| type      | string                                                                   | TRANSACTION\_CREATED                 |
| tenantId  | string                                                                   | The Fireblocks workspace's unique ID |
| timestamp | number                                                                   | Timestamp in milliseconds            |
| data      | [TransactionDetails](/reference/transaction-webhooks#transactiondetails) | All the transaction information      |

## Transaction Status Updated

A notification is sent when there is any change in a transaction's status or when the number of confirmations is updated.

| Parameter | Type                                                                     | Description                          |
| :-------- | :----------------------------------------------------------------------- | :----------------------------------- |
| type      | string                                                                   | TRANSACTION\_STATUS\_UPDATED         |
| tenantId  | string                                                                   | The Fireblocks workspace's unique ID |
| timestamp | number                                                                   | Timestamp in milliseconds            |
| data      | [TransactionDetails](/reference/transaction-webhooks#transactiondetails) | All the transaction informati        |

## NCW Transaction Status Updated (Immediate)

<Warning>
  ### In Early Access

  This webhook is currently part of an early access program. If you're interested in participating in the program, please [contact your Customer Success Manager](https://support.fireblocks.io/hc/en-us/requests/new?ticket_form_id=6947882197532) (requires a Help Center login).
</Warning>

In addition to the transaction status updates which are being sent in a chronological order (and not immediately), NCW transaction status updates are being sent right away. This is mainly to allow your backend to receive a notification that a transaction is pending signature as fast as possible.

**Note**: It will only be sent for outgoing transactions (withdrawals) with the following statuses:\
`PENDING_SIGNATURE`, `COMPLETED`, `CANCELLED`, `FAILED`, `BLOCKED`, `REJECTED`

| Parameter | Type                                                                     | Description                          |
| :-------- | :----------------------------------------------------------------------- | :----------------------------------- |
| type      | string                                                                   | NCW\_TRANSACTION\_STATUS\_UPDATED    |
| tenantId  | string                                                                   | The Fireblocks workspace's unique ID |
| timestamp | number                                                                   | Timestamp in milliseconds            |
| data      | [TransactionDetails](/reference/transaction-webhooks#transactiondetails) | All the transaction information      |

## Multi-Device Request ID

| Parameter      | type   | Description                                                               |
| :------------- | :----- | :------------------------------------------------------------------------ |
| type           | string | NCW\_ADD\_DEVICE\_SETUP\_REQUESTED                                        |
| tenantId       | string | The Fireblocks workspace's unique ID                                      |
| timestamp      | number | Timestamp in milliseconds                                                 |
| data.walletId  | string | The wallet's unique ID                                                    |
| data.deviceId  | string | The device's unique ID                                                    |
| data.requestId | string | The join wallet request's unique ID; is delegated to the approving device |

<Info>
  ### Note

  The structure of `data.fieldName` comes to describe a payload with values under a key data.
</Info>

## Non-Custodial Wallet Created

| Parameter     | type    | Description                             |
| :------------ | :------ | :-------------------------------------- |
| type          | string  | NCW\_CREATED                            |
| tenantId      | string  | The Fireblocks workspace's unique ID    |
| timestamp     | number  | Timestamp in milliseconds               |
| data.walletId | string  | The wallet's unique ID                  |
| data.enabled  | boolean | Indicates whether the wallet is enabled |

## Non-Custodial Wallet Account Created

| Parameter      | type   | Description                              |
| :------------- | :----- | :--------------------------------------- |
| type           | string | NCW\_ACCOUNT\_CREATED                    |
| tenantId       | string | The Fireblocks workspace's unique ID     |
| timestamp      | number | Timestamp in milliseconds                |
| data.walletId  | string | The wallet's unique ID                   |
| data.accountId | string | The account's ID in the specified wallet |

## Non-Custodial Wallet Asset Created

| Parameter      | type   | Description                                              |
| :------------- | :----- | :------------------------------------------------------- |
| type           | string | NCW\_ASSET\_CREATED                                      |
| tenantId       | string | The Fireblocks workspace's unique ID                     |
| timestamp      | number | Timestamp in milliseconds                                |
| data.walletId  | string | The wallet's unique ID                                   |
| data.accountId | string | The account's ID in the specified wallet                 |
| data.asset     | string | The asset's ID as defined in Fireblocks (BTC, ETH, etc.) |

## Non-Custodial Wallet Asset balance changed

<Warning>
  ### In Early Access

  This webhook is currently part of an early access program. If you're interested in participating in the program, please [contact your Customer Success Manager](https://support.fireblocks.io/hc/en-us/requests/new?ticket_form_id=6947882197532) (requires a Help Center login).
</Warning>

Notification is sent when an asset's balance changes.

| Parameter     | type                                                                                                   | Description                          |
| :------------ | :----------------------------------------------------------------------------------------------------- | :----------------------------------- |
| type          | string                                                                                                 | END\_USER\_WALLET\_BALANCE\_UPDATE   |
| tenantId      | string                                                                                                 | The Fireblocks workspace's unique ID |
| timestamp     | number                                                                                                 | Timestamp in milliseconds            |
| data.walletId | string                                                                                                 | The wallet's unique ID               |
| data          | [NcwAssetBalanceUpdate](https://ncw-developers.fireblocks.com/docs/data-objects#ncwassetbalanceupdate) | NCW asset details                    |