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 Bookings / Guests API

The Bookings / Guests API from Cal.com — 1 operation(s) for bookings / guests.

Cal.com Bookings / Guests 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 Bookings / Guests. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 1 operation across 1 path, and defines 11 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.

1 operations 1 paths 11 schemas 1 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 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Bookings / Guests 1
POST
/v2/bookings/{bookingUid}/guests
Add guests to an existing booking
BookingGuestsController_2024_08_13_addGuests 3 params body → 200

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are RecurringBookingOutput_2024_08_13 (29 properties), BookingOutput_2024_08_13 (28 properties), GetRecurringSeatedBookingOutput_2024_08_13 (27 properties), GetSeatedBookingOutput_2024_08_13 (26 properties). Each schema is shown below with its type and property counts.

AddGuestsOutput_2024_08_13
object
2 properties 2 required
RecurringBookingOutput_2024_08_13
object
29 properties 18 required
Guest
object
5 properties 1 required
GetRecurringSeatedBookingOutput_2024_08_13
object
27 properties 17 required
BookingHost
object
6 properties 6 required
EventType
object
2 properties 2 required
SeatedAttendee
object
10 properties 7 required
BookingAttendee
object
7 properties 5 required
BookingOutput_2024_08_13
object
28 properties 17 required
GetSeatedBookingOutput_2024_08_13
object
26 properties 16 required
AddGuestsInput_2024_08_13
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cal-com-bookings-guests-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 Cal Unified Calendars 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