Skip to main content
The base webhook endpoints (create, list, delete) are documented under API Reference → Webhooks. This page covers operational endpoints for testing and debugging delivery.

​
Send test event

Issues a synthetic webhook.test event to the endpoint. The synthetic event is signed and counted toward the endpoint’s delivery history. 
POST /v1/webhooks/{id}/test

curl -X POST https://api.qustody.io/v1/webhooks/wh_01HXYZ/test \
  -H "Authorization: Bearer $QUSTODY_API_KEY"
Response 200 
{
  "delivery_id": "del_01HXYZ...",
  "status": "delivered",
  "http_status": 200,
  "duration_ms": 142,
  "attempt": 1
}
If your receiver returns >= 400, the test still counts as a delivery attempt and is retried per the configured backoff.

​
Replay a delivery

Re-sends a previously emitted delivery. Useful when your receiver was down and the dead-letter window expired before it recovered. 
POST /v1/webhooks/{id}/replay/{deliveryId}

curl -X POST https://api.qustody.io/v1/webhooks/wh_01HXYZ/replay/del_01HXYZ \
  -H "Authorization: Bearer $QUSTODY_API_KEY"
The replayed payload is byte-identical to the original; the HMAC signature also matches the original. Receivers should treat replays as idempotent.

​
List deliveries

GET /v1/webhooks/{id}/deliveries?status=failed&from=2026-04-27T00:00:00Z&page=1&per_page=50
Filters
ParamDescription
statusdelivered, failed, dead_lettered
event_typeOne of the 12 event types
from / toTime range
Response 200 
{
  "deliveries": [
    {
      "id": "del_01HXYZ...",
      "endpoint_id": "wh_01HXYZ...",
      "event_type": "transaction.confirmed",
      "event_id": "evt_01HXYZ...",
      "status": "delivered",
      "http_status": 200,
      "attempt": 1,
      "duration_ms": 87,
      "next_retry_at": null,
      "delivered_at": "2026-04-27T10:15:00Z"
    }
  ]
}

​
Required permissions

EndpointPermission
POST /v1/webhooks/{id}/testwebhooks:update
POST /v1/webhooks/{id}/replay/{deliveryId}webhooks:update
GET /v1/webhooks/{id}/deliverieswebhooks:read