https://api.cal.id and is authenticated with a bearer API key, so you can drive scheduling from your own apps, scripts, and backends.
Authenticate every request by sending your key in the header:
Authorization: Bearer calid_xxxxx.Get set up
Ten minutes from zero to your first authenticated call.Quickstart
Make your first authenticated request and read the response envelope.
Get your API key
Create, name, expire, and rotate the keys that authenticate your requests.
Find your Event Type ID
Locate the IDs you pass to the slots, booking, and event-type endpoints.
Guides
Task-shaped recipes that string several endpoints together. Each one is copy-pasteable and ends with a working request.Create a booking
Find an open slot for an event type, then post the booking for it.
Reserve a slot before booking
Hold a time while the booker completes checkout, so nobody else takes it.
List and filter bookings
Query bookings with filters, sorting, and pagination.
Reschedule and cancel bookings
Move a booking to a new time, or cancel it and handle refunds.
Manage event types
Create, list, update, and delete the meetings people can book.
Manage availability schedules
Build the schedules that decide when an event type is bookable.
Manage team members
Add, list, update, and remove memberships and roles on a team.
Work with contacts
Create, search, and update contacts, and look up their meetings.
Build a webhook receiver
Subscribe to events and handle incoming deliveries in your own service.
Events and real-time updates
Stop polling. Have Cal ID tell you when something changes.Webhooks
Every available trigger, and how to attach webhooks to an account or event type.
Webhook event reference
Payload schemas for each trigger, plus signature verification.
Reference
The full surface area, plus the operational details that keep an integration healthy in production.API Reference
Every endpoint with full schemas and a live “Try it” playground.
API integration overview
Servers, authentication, response envelopes, and common pitfalls.
Rate limits
Read the
X-RateLimit-* headers and back off cleanly from a 429.Error codes
What each status code and error code means, and how to recover.
Prefer no code?
If you want bookings to trigger actions without writing a listener, connect Cal ID to an automation platform instead.Zapier
Trigger Zaps across thousands of apps on every new booking.
Make
Run a Make scenario the moment a meeting is scheduled.
Pabbly
Forward booking events to 1,000+ apps with Pabbly Connect.