Docs

Create Booking

Creates a booking in Cal.com.

POST

Query

Field selectionChoose which fields should be included in the response. Learn more
string

Comma-separated response fields to include.

Body

Arguments
stringrequired

Booking start time in ISO 8601 UTC format.

objectrequired

Attendee object including at least name and timeZone.

stringrequired

Attendee full name.

string

Attendee email address.

stringrequired

Attendee IANA time zone.

string

Attendee language code.

string

Attendee phone number.

string

Event type ID to book when using ID-based routing.

string

Event type slug to book when using slug-based routing.

string

Username owner for the event type route.

string

Team slug for team-scoped booking routes.

string

Organization slug for org-scoped booking routes.

array of string

Guest email list to include in the booking.

string

Override meeting URL for this booking.

object

Booking location payload.

string

Location type discriminator.

string

Location value for custom location types.

string

Address value when using physical/in-person location types.

string

Phone number when using phone location types.

string

Integration identifier for integration-backed location types.

object

Dynamic booking field responses map.

object

Custom metadata object for the booking.

number

Override booking duration in minutes.

object

Routing payload for round-robin or queued routing.

string

Queued routing response identifier.

number

Routing response identifier.

array of number

Candidate team member IDs for routing.

string

Team member email for routing.

boolean

Skip assigning the contact owner during routing.

string

CRM app slug used by routing rules.

string

CRM owner record type used in routing.

string

Email verification code for protected event types.

boolean

Create instant booking when supported.

number

Recurring booking count for recurring event types.

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is
One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.
Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.
Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.