published

Cal.com Scheduling API

Cal.com offers developers an open-source REST API for managing schedules, bookings, and event types, with support for both cloud and self-hosted environments.

Developed by Cal.com

View Source
99.90%Uptime
200msLatency
39.5kStars
API KeyAuth
NoCredit Card
RESTStyle
v2Version
API Endpoints

Reference for available routes, request structures, and live examples.

Schedules a new meeting booking

Full Endpoint URL
http://localhost:3000/bookings
Implementation Example
curl -X POST 'http://localhost:3000/bookings' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Request Payload
{
  "start": "2023-07-25T14:00:00Z",
  "responses": {
    "name": "John",
    "email": "[email protected]"
  },
  "eventTypeId": 123
}
Expected Response
{
  "id": "abc123",
  "uid": "bFGrVyX1",
  "attendees": [
    {
      "email": "[email protected]"
    }
  ],
  "startTime": "2023-07-25T14:00:00Z"
}
Version:v2
Limit:100 requests/hour
Real-World Applications
  • Embedding scheduling in SaaS webappsOptimized Capability
  • Building mobile booking appsOptimized Capability
  • Syncing bookings with CRM systemsOptimized Capability
  • Creating custom availability dashboardsOptimized Capability
Advantages
  • ✓ Open‑source and self‑hostable
  • ✓ Modern REST API with pagination and expressive responses
  • ✓ Flexible authentication (API Key and OAuth2)
  • ✓ Rich, versioned documentation and migration support
  • ✓ Highly extensible for both small and enterprise use
Limitations
  • ✗ Enterprise features behind commercial license
  • ✗ Self‑hosting requires infrastructure setup
  • ✗ Rate limit constraints on higher throughput usage
  • ✗ Complex OAuth flows for team/platform endpoints

FAQs

API Specifications

v2
Pricing Model
Freemium with usage‑based add‑ons and enterprise plans
Credit Card
Not Required
Response Formats
JSON
Supported Languages
5 Languages
SDK Support
JavaScript (Node.js), Python
Time to Hello World

10–30 minutes for cloud, 1–2 hours for self‑hosted

Rate Limit

120 requests per minute (higher tiers available)

Free Tier Usage

Up to 50 bookings/month free on cloud, self‑hosted is fully free

Use Case: Best For

Developers needing customizable scheduling infrastructure

Not Recommended For

Teams requiring fully managed, plug‑and‑play SaaS scheduling without self‑hosting

Resources

Documentation Official Website Source Code Pricing Details Postman Collection
#calendar#scheduling

Explore Related APIs

Discover similar APIs to Cal.com Scheduling API

View All APIs
PAID

Microsoft Graph API

Microsoft Graph API provides a unified gateway for programmatic access to data across Microsoft 365 services, suitable for productivity apps and enterprise workflows.

ProductivityView Details
OPEN SOURCE

Nager.Date API

Nager.Date API provides developers with free access to accurate public holiday data and calendar information, suitable for scheduling and reminder applications.

CalendarView Details