Smart Transfer Webhooks

Deprecation noticeWebhooks v1 was deprecated on June 15, 2026. If your integration still relies on v1, it is at risk: v1 no longer receives fixes or enhancements, issue resolution is not guaranteed, and the service may be fully retired at any time without prior notice. 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.

This page describes all events relating to Fireblocks Smart Transfers that produce Webhook notifications, and their associated data objects. The type parameter is automatically set to the description name for the data objects below.

Ticket created

Notification is sent when a Smart Transfer ticket is created.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
type	string	The type of settlement for the ticket: Currently only async
status	string	The status of the ticket
createdByNetworkId	string	The network ID of the Fireblocks Network profile that created the ticket
createdByNetworkIdName	string	The name of the Fireblocks Network profile that created the ticket
createdAt	date	Time and date when the ticket was created
expiresIn	number	Expiration of the ticket in hours

Ticket counterparty added

Notification is sent when a counterparty is added to a Smart Transfer ticket.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
networkId	string	Network ID of the connection receiving a ticket
networkIdName	string	Name of the Fireblocks Network profile receiving the ticket

Ticket counterparty external ID added

Notification is sent when an external ID is added to a Smart Transfer ticket.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
externalRefId	string	Any ID a customer adds to the system

Ticket note added

Notification is sent when a note is added to a Smart Transfer ticket.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
body	string	Text of the note
createdAt	date	Time and date when the note was created

Ticket submitted

Notification is sent when a Smart Transfer ticket is submitted.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
expiresIn	number	Expiration of the ticket in hours
status	string	Status of the ticket
expiresAt	date	Date and time when the ticket expires
submittedAt	date	Date and time the ticket is submitted

Ticket expires at set

Notification is sent when a Smart Transfer ticket expiration is set.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
expiresAt	date	Date and time when the ticket expires

Ticket expires in set

Notification is sent when a Smart Transfer ticket expiration is set.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
expiresIn	number	Expiration of the ticket in hours

Ticket expired

Notification is sent when a Smart Transfer ticket expires.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
status	string	Status of the ticket
expiresAt	date	Date and time when the ticket expired

Ticket fulfilled

Notification is sent when a Smart Transfer ticket is fulfilled.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
fulfilledAt	date	Date and time when the ticket was fulfilled by both sides

Ticket canceled

Notification is sent when a Smart Transfer ticket is canceled.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
canceledAt	date	Date and time when the ticket was canceled

Ticket term added

Notification is sent when a Smart Transfer ticket term is added.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
asset	string	Asset name being sent in the term
amount	string	Amount of the asset being sent
fromNetworkId	string	NetworkId from which the asset is being sent
toNetworkId	string	NetworkId to which the asset is being sent
status	string	Status of the ticket

Ticket term updated

Notification is sent when a Smart Transfer ticket term is updated.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
asset	string	Asset name being sent in the term
amount	string	Amount of the asset being sent
fromNetworkId	string	NetworkId from which the asset is being sent
toNetworkId	string	NetworkId to which the asset is being sent

Ticket term deleted

Notification is sent when a Smart Transfer ticket term is deleted.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term

Ticket term funded

Notification is sent when a Smart Transfer ticket term is funded.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
asset	string	Asset name of the asset being sent to fund the term
amount	string	Amount of the asset being sent to fund the term
networkConnectionId	string	Network ID funding the term
srcId	string	vaultId if srcType is VAULT_ACCOUNT; exchangeId if srcType is EXCHANGE; or fiatAccountId if srcType is FIAT_ACCOUNT
srcType	string	Type of the account from which the funds are originating; can be a vault, an exchange, or a fiat account
note	string	Text of the note
fee	string	Amount of fee paid for the transaction funding the term
feeLevel	string	Fee level being paid

Ticket term manually funded

Notification is sent when a Smart Transfer ticket term is manually funded.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
txHash	string	TX hash of the transaction funding the term

Ticket term funding canceled

Notification is sent when a Smart Transfer ticket term’s funding is canceled.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
txStatus	string	Status of the transfer funding the term

Ticket term funding failed

Notification is sent when a Smart Transfer ticket term’s funding fails.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
txStatus	string	Status of the transfer funding the term

Ticket term funding completed

Notification is sent when a Smart Transfer ticket term’s funding is completed.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
txSHash	string	TX hash of the transaction funding the term
txStatus	string	Status of the transfer funding the term

Ticket term transaction status changed

Notification is sent when a Smart Transfer ticket term’s transaction status changes.

Parameter	Type	Description
ticketId	string	Unique ID for the ticket
termId	string	Unique ID of the term
txStatus	string	Status of the transfer funding the term

Get Started

Workspace & Security

Webhooks

Direct Custody Wallets

Manage Wallets

Embedded Wallets

Transactions

Transaction Fees & Gas Station

Treasury & Trading

Smart Contracts & Tokenization

Assets & NFTs

Compliance

Payments

Offchain Signing

API Co-Signers

Integrations

Ticket created

Ticket counterparty added

Ticket counterparty external ID added

Ticket note added

Ticket submitted

Ticket expires at set

Ticket expires in set

Ticket expired

Ticket fulfilled

Ticket canceled

Ticket term added

Ticket term updated

Ticket term deleted

Ticket term funded

Ticket term manually funded

Ticket term funding canceled

Ticket term funding failed

Ticket term funding completed

Ticket term transaction status changed

​Ticket created

​Ticket counterparty added

​Ticket counterparty external ID added

​Ticket note added

​Ticket submitted

​Ticket expires at set

​Ticket expires in set

​Ticket expired

​Ticket fulfilled

​Ticket canceled

​Ticket term added

​Ticket term updated

​Ticket term deleted

​Ticket term funded

​Ticket term manually funded

​Ticket term funding canceled

​Ticket term funding failed

​Ticket term funding completed

​Ticket term transaction status changed

Ticket created

Ticket counterparty added

Ticket counterparty external ID added

Ticket note added

Ticket submitted

Ticket expires at set

Ticket expires in set

Ticket expired

Ticket fulfilled

Ticket canceled

Ticket term added

Ticket term updated

Ticket term deleted

Ticket term funded

Ticket term manually funded

Ticket term funding canceled

Ticket term funding failed

Ticket term funding completed

Ticket term transaction status changed