Webhooks & API Access

For developers and advanced users, Calimatic offers webhooks and a REST API to build custom integrations.

Webhooks

Webhooks send real-time notifications to your server when events occur. Available on Pro and Enterprise plans.

Setting Up Webhooks:

1. Go to Settings > Webhooks.
2. Click New Webhook.
3. Enter your endpoint URL.
4. Select the events to subscribe to:
- booking.created, booking.confirmed, booking.cancelled
- booking.rescheduled, booking.completed
- event_type.created, event_type.updated, event_type.deleted
5. Optionally set a secret for payload verification.
6. Save and activate.

Payload Security:
Each webhook delivery includes a signature header. Verify it using your webhook secret to ensure the payload is authentic.

REST API

The API lets you programmatically manage event types, bookings, availability, and more. Available on Enterprise plans.

Authentication:
Generate an API key from Settings > API. Include it in request headers:

Authorization: Bearer your-api-key

Endpoints include:
- GET /api/v1/event-types — List event types
- GET /api/v1/bookings — List bookings
- POST /api/v1/bookings — Create a booking
- GET /api/v1/availability — Check available slots

Rate Limits

Default: 1000 requests per hour per API key.
Enterprise: Custom limits available.

Tips

Start with webhooks for real-time notifications before building API integrations.
Use a tool like Postman to explore the API before writing code.
Store your API key securely — never expose it in client-side code.
Monitor webhook delivery status to catch failures early.

Webhooks & API Access