Skip to main content
There are two methods to configure webhooks using the Webhooks v2 service:
  • Via the Fireblocks Console
  • Via the Fireblocks API & SDKs (requires an API key with Admin-level permissions)
Before configuring webhooks, note the following requirements:
  • Only Admin-level users (Owner, Admin, and Non-Signing Admin) can configure webhooks.
  • Each webhook URL must be a legal, globally available HTTPS address (e.g., https://example.com) accessible via port 443.
  • Webhook URLs cannot exceed 255 characters in length.
  • You can enter up to 10 webhook URLs.
If you’re looking for information about Audit Event Webhooks for monitoring your workspace’s audit log, check out this Help Center article instead.
Starting November 2025, BALANCE_UPDATE events are available through Webhooks V2. You can self-subscribe via the Console or API. Manual enablement by Fireblocks is no longer supported.

​
Via the Console

​
Creating a webhook

  1. In the Fireblocks Console, go to Developer center > Webhooks and then select Create webhook.
  2. On the Create webhook dialog, complete the following fields:
    1. Endpoint URL: Enter the webhook’s URL address.
    2. Description: Optionally, enter a short description of the webhook.
    3. Status: Select whether you want the webhook to be active or inactive.
    4. Listen for: Select an event category to listen for all its associated events, or select the specific events to listen for from each category.
  3. Select Create webhook.

​
Editing a webhook

  1. In the Fireblocks Console, go to Developer center > Webhooks.
  2. Find the webhook you want to edit, then select More actions (…) > Edit webhook.
  3. On the Edit webhook dialog, make the necessary changes and then select Save.

​
Deactivating & Activating a webhook

  1. In the Fireblocks Console, go to Developer center > Webhooks.
  2. Find the webhook you want to deactivate or activate, then select More actions (…) > Deactivate webhook or Activate webhook.
  3. On the Deactivate or Activate webhook dialog, select Deactivate or Activate.

​
Deleting a webhook

  1. In the Fireblocks Console, go to Developer center > Webhooks.
  2. Find the webhook you want to delete, then select More actions (…) > Delete webhook.
  3. On the Delete webhook dialog, select Delete.

​
Via the API & SDKs

​
Creating a webhook

Use the createWebhook command, which uses the Create a new webhook endpoint. 
curl --request POST \
     --url 'https://api.fireblocks.io/v1/webhooks' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"enabled":true}'

​
Updating a webhook

Use the updateWebhook command, which uses the Update webhook endpoint. 
curl --request PATCH \
     --url 'https://api.fireblocks.io/v1/webhooks/webhookId' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

​
Deleting a webhook

Use the deleteWebhook command, which uses the Delete a webhook endpoint. 
curl --request DELETE \
     --url 'https://api.fireblocks.io/v1/webhooks/webhookId' \
     --header 'accept: application/json'
Migrating to Webhooks v2 from Webhooks v1? Start with our Webhooks v2 Migration Guide to learn more about the benefits of and key changes in the Webhooks v2 service, and to find a mapping guide for converting your Webhooks v1 events to Webhooks v2 events.