VardaCal VardaCal Developer API

Webhook Events

VardaCal can send webhook events to notify your application when something happens in your account.

Available Events

Booking Events

  • booking.created Triggered when a new booking is created
  • booking.cancelled Triggered when a booking is cancelled
  • booking.rescheduled Triggered when a booking is rescheduled
  • booking.confirmed Triggered when a booking is confirmed by the host
  • booking.reminder.sent Triggered when a reminder is sent for a booking

Event Type Events

  • event_type.created Triggered when a new event type is created
  • event_type.updated Triggered when an event type is updated
  • event_type.deleted Triggered when an event type is deleted

Webhook Security

Every webhook request includes a signature in the X-VardaCal-Signature header. Verify this signature to ensure the webhook came from VardaCal.

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}