Skip to main content
Stop polling our API and let us tell you when something important happens. Webhooks allow you to receive real-time notifications about events that occur within your Dfns organization. Instead of constantly querying our API to check the status of a transaction or a policy, you can configure Dfns to send an HTTP POST request directly to your specified URL as soon as an event occurs. This event-driven approach is more efficient and enables you to build responsive, automated workflows. For example, you can use webhooks to:
  • Get instant notifications on the entire transaction lifecycle: Created, Signed, Broadcasted, Confirmed, or Failed.
  • Trigger internal alerts when a policy requires your team’s approval.
  • Update a customer’s order status in your database as soon as a payment is confirmed on-chain.
All webhook requests are signed so you can cryptographically verify that they originated from Dfns. This guide will walk you through how to set up, secure, and subscribe to webhook events.

​
API reference

GET/webhooks List Webhooks POST/webhooks Create Webhook GET/webhooks/{webhookId} Get Webhook PUT/webhooks/{webhookId} Update Webhook DEL/webhooks/{webhookId} Delete Webhook POST/webhooks/{webhookId}/ping Ping Webhook

​
Webhook object

​
id
string
required

Webhook ID

​
url
string
required

Webhook url

​
events
enum<string>[]
required

All events this webhook is subscribed to.

WebhookEventKind

Available options:
policy.triggered,
policy.approval.pending,
policy.approval.resolved,
key.created,
key.deleted,
key.delegated,
key.exported,
wallet.blockchainevent.detected,
wallet.created,
wallet.activated,
wallet.delegated,
wallet.exported,
wallet.signature.failed,
wallet.signature.rejected,
wallet.signature.requested,
wallet.signature.signed,
wallet.transaction.broadcasted,
wallet.transaction.confirmed,
wallet.transaction.failed,
wallet.transaction.rejected,
wallet.transaction.requested,
wallet.transfer.broadcasted,
wallet.transfer.confirmed,
wallet.transfer.failed,
wallet.transfer.rejected,
wallet.transfer.requested,
wallet.offer.received,
wallet.offer.accepted,
wallet.offer.rejected,
wallet.offer.withdrawn,
wallet.tags.modified,
payout.action.required
​
status
enum<string>
required

Webhook status

Available options:
Enabled,
Disabled
​
dateCreated
string
required

Date when webhook was created

​
dateUpdated
string
required

Date when webhook was last updated

​
secret
string
required

The secret associated with this webhook, with which webhook requests will be signed.

​
description
string

Short description this webhook's purpose

Last modified on February 16, 2026