Webhook Overview
Webhooks push data to your systems in real time when something happens in LodgeKit — a booking is created, an invoice is paid, a guest checks in. Instead of polling the API, your system receives an HTTP POST when events occur.
Creating a Webhook Subscription
Go to Dashboard > Settings > Webhooks and click Add Webhook. Enter your endpoint URL (must be HTTPS), select the events you want to subscribe to, and save. LodgeKit sends a test event to verify your endpoint is working.
Available Events
Subscribe to events across all resources: booking.created, booking.updated, booking.cancelled, invoice.created, invoice.sent, invoice.paid, payment.received, payment.refunded, guest.created, guest.updated. Each event payload includes the full resource object.
Verifying Webhook Signatures
Every webhook request includes a signature header for verification. Use your webhook secret (shown during setup) to compute an HMAC-SHA256 hash of the request body and compare it to the signature. This ensures the request genuinely came from LodgeKit.
Retry Policy
If your endpoint returns a non-2xx status code, LodgeKit retries the delivery with exponential backoff — after 1 minute, 5 minutes, 30 minutes, and 2 hours. After 4 failed attempts, the delivery is marked as failed. You can view and manually retry failed deliveries from the webhook settings page.
Was this article helpful?