> ## 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": "/reference/webhooks-structures-notificationstructure",
  "feedback": "Description of the issue"
}
```

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

</AgentInstructions>

# Webhook notification structure

The table below shows the structure of every webhook notification generated by the Fireblocks webhook service.

| Field       | Type          | Description                                                                          |
| ----------- | ------------- | ------------------------------------------------------------------------------------ |
| id          | UUID          | Unique identifier of the object.                                                     |
| resourceId  | string        | Optional: the ID of the entity that triggered the event (e.g., txId).                |
| webhookId   | UUID          | The ID of the client-side endpoint.                                                  |
| workspaceId | UUID          | The ID of the workspace that generated the webhook notification.                     |
| eventType   | string (enum) | The type of event that triggered the webhook notification.                           |
| createdAt   | timestamp     | Time at which the object was created, measured in milliseconds since the Unix epoch. |
| data        | object        | The object containing the data associated with the event.                            |

***

## Example notifications

### vault\_account.asset.added notification

```
{
  "id": "........-....-....-....-............",
  "workspaceId": "........-....-....-....-............",
  "eventType": "vault_account.asset.added",
  "createdAt": 1754494189479,
  "data": {
    "accountId": "21",
    "accountName": "test6",
    "assetId": "XRP_TEST"
  }
}
```

### transaction.created notification (with resourceId)

```
{
  "id": "........-....-....-....-............",
  "resourceId": "........-....-....-....-............",
  "webhookId": "........-....-....-....-............",
  "workspaceId": "........-....-....-....-............",
  "eventType": "transaction.created",
  "createdAt": 1754229343763,
  "data": {
    "id": "........-....-....-....-............",
    "createdAt": 1754229343505,
    "lastUpdated": 1754229343505,
    "assetId": "XRP_TEST",
    "source": {
      "id": "0",
      "type": "VAULT_ACCOUNT",
      "name": "Default",
      "subType": ""
    },
    "destination": {
      "id": "1",
      "type": "VAULT_ACCOUNT",
      "name": "1",
      "subType": ""
    },
    "amount": 11,
    "fee": -1,
    "networkFee": -1,
    "netAmount": -1,
    "sourceAddress": "",
    "destinationAddress": "",
    "destinationAddressDescription": "",
    "destinationTag": "",
    "status": "SUBMITTED",
    "txHash": "",
    "subStatus": "",
    "signedBy": [],
    "createdBy": "........-....-....-....-............",
    "rejectedBy": "",
    "amountUSD": 11,
    "addressType": "",
    "note": "",
    "exchangeTxId": "",
    "requestedAmount": 11,
    "feeCurrency": "XRP_TEST",
    "operation": "TRANSFER",
    "customerRefId": null,
    "amountInfo": {
      "amount": "11",
      "requestedAmount": "11",
      "amountUSD": "11.00"
    },
    "feeInfo": {},
    "destinations": [],
    "externalTxId": null,
    "blockInfo": {},
    "signedMessages": [],
    "assetType": "BASE_ASSET"
  }
}
```