Skip to main contentStop 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