Deprecation noticeWebhooks v1 has been in soft deprecation since June 15, 2026: it receives no fixes or enhancements, and issue resolution is not guaranteed. Starting October 5, 2026, v1 is being shut down permanently in phases, with all workspaces affected by October 28, 2026. Once shut down, v1 stops delivering notifications and cannot be restored. Fireblocks is not responsible for missed or delayed notifications or any disruption resulting from continued use of Webhooks v1. Upgrade to Webhooks v2 now via the Developer Center in the Fireblocks Console. For upgrade steps and event mapping, see the Webhooks v2 Migration Guide.
Settlement Created
A notification is sent when a new settlement is initiated in the workspace.| Parameter | Type | Description |
|---|---|---|
| type | string | SETTLEMENT_CREATED |
| tenantId | string | Unique ID of your Fireblocks workspace. |
| timestamp | number | Timestamp in milliseconds. |
| data | settlementDetails | Settlement details. |
settlementDetails
| Parameter | Type | Description |
|---|---|---|
| collateralAccountId | string | The collateral account ID. |
| settlementId | string | Unique settlement ID provided by Fireblocks. |
| isForceSettlement | boolean | A flag or condition that indicates whether a settlement should be forcibly executed, overriding normal settlement procedures. |
| exchangeAccountId | string | The ID of the exchange account. |
| toExchange | data [array] | All settlement transaction details are required to be sent to the exchange. |
| toCollateral | data [array] | All settlement transaction details are required to be sent to the collateral account. |
toExchange
| Parameter | Type | Description |
|---|---|---|
| txId | string | The transaction ID (within the main workspace). |
| assetId | string | The ID of the transaction’s asset, applicable to TRANSFER, MINT, BURN, or ENABLE_ASSET operations. For a list of supported assets and their corresponding IDs, please refer here. |
| amount | string | The actual amount requested for transfer. |
toCollateral
| Parameter | Type | Description |
|---|---|---|
| txId | string | The transaction ID (within the main workspace). |
| assetId | string | The ID of the transaction’s asset, applicable to TRANSFER, MINT, BURN, or ENABLE_ASSET operations. For a list of supported assets and their corresponding IDs, please refer here. |
| amount | string | The actual amount requested for transfer. |
Sample Payload
{
"type": "SETTLEMENT_CREATED",
"tenantId": "your-tenant-id", (main tenant Id)
"timestamp": 1633036800000,
"settlementDetails": {
"collateralAccountId": "collateral-account-id", COLLATERAL Account ID (not collateral ID)
"settlementId": "settlement-id",
"isForceSettlement": false,
"toExchange": [
{
"txId": "transaction-id-1",
"assetId": "asset-id-1",
"amount": "1000",
}],
"toCollateral": [
{
"txId": "transaction-id-2",
"assetId": "asset-id-2",
"amount": "500",
}]
}
}