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
I