Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cal.com Cal Unified Calendars API

The Cal Unified Calendars API from Cal.com — 8 operation(s) for cal unified calendars.

Cal.com Cal Unified Calendars API is one of 22 APIs that Cal.com publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Cal Unified Calendars. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 15 operations across 8 paths, and defines 23 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against the base URL https://api.cal.com/v2.

15 operations 8 paths 23 schemas 2 DELETE8 GET3 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.cal.com/v2
Resource Areas
1

Paths & Operations 15

Across 8 paths, the API surfaces 15 operations — 2 DELETE, 8 GET, 3 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Cal Unified Calendars 15
GET
/v2/calendars/connections
List calendar connections
CalUnifiedCalendarsController_listConnections 1 param → 200
GET
/v2/calendars/connections/{connectionId}/events
List events for a connection
CalUnifiedCalendarsController_listConnectionEvents 6 params → 200
POST
/v2/calendars/connections/{connectionId}/events
Create event on a connection
CalUnifiedCalendarsController_createConnectionEvent 3 params body → 201
GET
/v2/calendars/connections/{connectionId}/events/{eventId}
Get event for a connection
CalUnifiedCalendarsController_getConnectionEvent 4 params → 200
PATCH
/v2/calendars/connections/{connectionId}/events/{eventId}
Update event for a connection
CalUnifiedCalendarsController_updateConnectionEvent 4 params body → 200
DELETE
/v2/calendars/connections/{connectionId}/events/{eventId}
Delete event for a connection
CalUnifiedCalendarsController_deleteConnectionEvent 4 params → 204
GET
/v2/calendars/connections/{connectionId}/freebusy
Get free/busy for a connection
CalUnifiedCalendarsController_getConnectionFreeBusy 5 params → 200
GET
/v2/calendars/{calendar}/events/{eventUid}
Get meeting details from calendar
CalUnifiedCalendarsController_getCalendarEventDetails 3 params → 200
PATCH
/v2/calendars/{calendar}/events/{eventUid}
Update meeting details in calendar
CalUnifiedCalendarsController_updateCalendarEvent 3 params body → 200
DELETE
/v2/calendars/{calendar}/events/{eventUid}
Delete a calendar event
CalUnifiedCalendarsController_deleteCalendarEvent 3 params → 204
GET
/v2/calendars/{calendar}/event/{eventUid}
Get meeting details from calendar
CalUnifiedCalendarsController_getCalendarEventDetails 3 params → 200
PATCH
/v2/calendars/{calendar}/event/{eventUid}
Update meeting details in calendar
CalUnifiedCalendarsController_updateCalendarEvent 3 params body → 200
GET
/v2/calendars/{calendar}/events
List calendar events
CalUnifiedCalendarsController_listCalendarEvents 6 params → 200
POST
/v2/calendars/{calendar}/events
Create a calendar event
CalUnifiedCalendarsController_createCalendarEvent 2 params body → 201
GET
/v2/calendars/{calendar}/freebusy
Get free/busy times
CalUnifiedCalendarsController_getFreeBusy 5 params → 200

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are UnifiedCalendarEventOutput (11 properties), CalendarEventPhoneLocation (7 properties), CalendarEventAttendee (6 properties), CalendarEventVideoLocation (6 properties). Each schema is shown below with its type and property counts.

CalendarEventSipLocation
object
5 properties 2 required
ListConnectionsOutput
object
2 properties 2 required
CalendarConnectionItem
object
3 properties 2 required
BusyTimesOutput
object
3 properties 2 required
CalendarEventMoreLocation
object
3 properties 2 required
ListConnectionsData
object
1 property 1 required
UnifiedCalendarEventOutput
object
11 properties 5 required
ListUnifiedCalendarEventsOutput
object
2 properties 2 required
CalendarEventVideoLocation
object
6 properties 2 required
CalendarEventStatus
string
Status of the event (accepted, pending, declined, cancelled)
UpdateCalendarEventAttendee
object
6 properties
CalendarEventAttendee
object
6 properties 1 required
CalendarEventResponseStatus
string
Response status of the attendee
CreateEventDateTimeWithZone
object
2 properties 2 required
GetUnifiedCalendarEventOutput
object
2 properties 2 required
CalendarEventHost
object
3 properties 1 required
GetBusyTimesOutput
object
2 properties 2 required
UpdateUnifiedCalendarEventInput
object
6 properties
CalendarSource
string
Calendar integration source (e.g., Google Calendar, Office 365, Apple Calendar). Currently only Google Calendar is supported.
CreateUnifiedCalendarEventInput
object
5 properties 3 required
CalendarEventPhoneLocation
object
7 properties 2 required
calendarEventOwner
object
2 properties 1 required
CreateEventAttendee
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cal-com-cal-unified-calendars-api-openapi.yml Raw ↑

Other APIs Cal.com publishes across the network.

Cal.com Api Keys API
Cal.com Bookings API
Cal.com Bookings / Attendees API
Cal.com Bookings / Guests API
Cal.com Calendars API
Cal.com Conferencing API
Cal.com Deprecated: Platform / Managed Users API
Cal.com Deprecated: Platform OAuth Clients API
Cal.com Deprecated: Platform / Webhooks API
Cal.com Destination Calendars API
Cal.com Event Types API
Cal.com Event Types Private Links API