Setting a webhook lets you receive Fireblocks workspace event notifications, such as incoming and outgoing transactions, transaction status updates, new vault accounts, new wallets, new external and internal addresses, and many more.

For instructions on how to connect a webhook to your Fireblocks workspace, see here. After you connect to a webhook, you will receive event notifications for that workspace. All events are sent with the following headers:

Fireblocks-Signature = Base64(RSA512(WEBHOOK_PRIVATE_KEY, SHA512(eventBody)))
Fireblocks-API-Version = "1.4.0"

Fireblocks sends a POST request to the URL(s) associated with the workspace and expects a 200 response. If Fireblocks doesn't receive a response, it continues to resend the request with an increasing delay between each attempt. The retry attempts occur after [ 15, 45, 105,225, 465, 945, 1905, 3825, 7665, 15345 ] seconds.

On the language tabs, there are examples of how to set up the server and verify the signature header of the request. Download the public key for verifying the signature here.