Docs/Webhooks/Reservation

reservation.cancelled

Fired when a reservation is cancelled by the guest, host, or platform.

Payload

{
  "event": "reservation.cancelled",
  "timestamp": "2026-04-04T16:00:00Z",
  "data": {
    "id": "215906",
    "confirmationCode": "HMA1234567",
    "cancellationReason": "guest_requested",
    "refundAmount": "1250.00"
  }
}

Handler Example

if (event === 'reservation.cancelled') {
  console.log('Booking cancelled:', data.confirmationCode, data.cancellationReason)
  // Process refund, unblock calendar, etc.
}

Tip: Always return a 200 status code to acknowledge receipt. Failed deliveries are retried 3 times with exponential backoff.Learn more about webhook reliability →

AI