Get Webhook

Retrieve information about a specific webhook.

GET /webhooks/{webhookId}

Get Webhook

cURL

curl --request GET \
  --url https://api.dfns.io/webhooks/{webhookId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "url": "<string>",
  "events": [],
  "dateCreated": "<string>",
  "dateUpdated": "<string>",
  "description": "<string>"
}

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Webhooks:Read: Always required.

Authorizations

Authorization · string · header · required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

webhookId · string · required

Minimum string length: 1

Response

200 - application/json

Success

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

description · string

Short description this webhook's purpose