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.testPayload shape
{
"id": "uuid",
"type": "registration.created",
"orgId": "uuid",
"eventId": "uuid",
"createdAt": "2026-07-07T00:00:00.000Z",
"data": { "registrationId": "uuid" }
}