Testing Webhooks

Send a test ping

From the dashboard Developers → Webhooks → Send test, or via the API:

POST/v1/webhooks/endpoints/{id}/test

Field	Type	Description
`event_type`required	string	e.g. user.kyc.status_changed

curl -X POST https://api.vaultspay.ae/v1/webhooks/endpoints/whk_01HX7.../test \
  -H "Authorization: Bearer sk_test_yourApiKeyHere" \
  -H "Content-Type: application/json" \
  -d '{ "event_type": "user.kyc.status_changed" }'

Inspecting deliveries

Every delivery attempt is stored for 90 days with full request, headers, response body, and status.

GET/v1/webhooks/endpoints/{id}/deliveries

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "dlv_01HX7...",
      "event_id": "evt_01HX7...",
      "attempt": 1,
      "status_code": 200,
      "duration_ms": 124,
      "delivered_at": "2026-04-24T14:52:04Z"
    }
  ]
}

Local development

For local testing, use a tunnel tool like ngrok or Cloudflare Tunnel:

ngrok http 3000
# → https://abcdef1234.ngrok.io  (use this as your webhook URL)

Managing Endpoints Errors