DocumentationDashboard →

Webhook events

Signed outbound events

vFurst sends JSON envelopes to public HTTPS endpoints and retries transient failures through BullMQ. Each endpoint has its own job and stable delivery ID across retries.

Headers

x-vfurst-event
Event type, such as registration.created.
x-vfurst-timestamp
Unix timestamp used in the signature base string.
x-vfurst-signature
HMAC-SHA256 of timestamp.body using the endpoint secret.

Delivery security

Verify the timestamp and HMAC against the exact raw body before parsing JSON, compare signatures in constant time, and deduplicate the payload ID. Private/local DNS answers, IP-literal targets, credentials, redirects, and timed-out requests are rejected.

Event catalog

event.publishedregistration.createdregistration.checked_inorder.paidorder.refundedhotel_booking.createdvolunteer_application.submittedvendor_application.submittedwebhook.test

Payload shape

{
  "id": "uuid",
  "type": "registration.created",
  "orgId": "uuid",
  "eventId": "uuid",
  "createdAt": "2026-07-07T00:00:00.000Z",
  "data": { "registrationId": "uuid" }
}