openclaw-backups/skills/api-gateway/references/cal-com.md

Cal.com Routing Reference

App name: cal-com Base URL proxied: api.cal.com

API Path Pattern

/cal-com/v2/{resource}

Common Endpoints

User Profile

Get Profile

GET /cal-com/v2/me

Update Profile

PATCH /cal-com/v2/me

Event Types

List Event Types

GET /cal-com/v2/event-types

Get Event Type

GET /cal-com/v2/event-types/{eventTypeId}

Create Event Type

POST /cal-com/v2/event-types

Update Event Type

PATCH /cal-com/v2/event-types/{eventTypeId}

Delete Event Type

DELETE /cal-com/v2/event-types/{eventTypeId}

Event Type Webhooks

List Webhooks

GET /cal-com/v2/event-types/{eventTypeId}/webhooks

Create Webhook

POST /cal-com/v2/event-types/{eventTypeId}/webhooks

Get Webhook

GET /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}

Update Webhook

PATCH /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}

Delete Webhook

DELETE /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}

Bookings

List Bookings

GET /cal-com/v2/bookings
GET /cal-com/v2/bookings?status=upcoming
GET /cal-com/v2/bookings?status=past
GET /cal-com/v2/bookings?status=cancelled
GET /cal-com/v2/bookings?take=10

Get Booking

GET /cal-com/v2/bookings/{bookingUid}

Create Booking

POST /cal-com/v2/bookings

Cancel Booking

POST /cal-com/v2/bookings/{bookingUid}/cancel

Schedules

Get Default Schedule

GET /cal-com/v2/schedules/default

Get Schedule

GET /cal-com/v2/schedules/{scheduleId}

Create Schedule

POST /cal-com/v2/schedules

Update Schedule

PATCH /cal-com/v2/schedules/{scheduleId}

Delete Schedule

DELETE /cal-com/v2/schedules/{scheduleId}

Availability Slots

Get Available Slots

GET /cal-com/v2/slots/available?eventTypeId={id}&startTime={iso8601}&endTime={iso8601}

Reserve Slot

POST /cal-com/v2/slots/reserve

Calendars

List Connected Calendars

GET /cal-com/v2/calendars

Conferencing

List Conferencing Apps

GET /cal-com/v2/conferencing

Get Default Conferencing App

GET /cal-com/v2/conferencing/default

Webhooks (User-level)

List Webhooks

GET /cal-com/v2/webhooks

Create Webhook

POST /cal-com/v2/webhooks

Get Webhook

GET /cal-com/v2/webhooks/{webhookId}

Update Webhook

PATCH /cal-com/v2/webhooks/{webhookId}

Delete Webhook

DELETE /cal-com/v2/webhooks/{webhookId}

Teams

List Teams

GET /cal-com/v2/teams

Verified Resources

List Verified Emails

GET /cal-com/v2/verified-resources/emails

Notes

• All API endpoints are v2
• All times are in UTC (ISO 8601 format)
• Booking creation requires an available slot - check /v2/slots/available first
• Required fields for booking: eventTypeId, start, timeZone, language, responses.name, responses.email
• GET /v2/schedules may return 500 errors; use GET /v2/schedules/{id} instead
• Event type creation requires: title, slug, length (in minutes)

Resources

• Cal.com API Documentation