Skip to main content
POST
Create a new appointment booking through your connected Cal.com calendar. The booking will be added to your calendar and the attendee will receive a confirmation email.

Request Body

string
required
Appointment start time in ISO 8601 format. Must be an available slot.Example: 2024-01-15T14:00:00-08:00
string
required
Attendee’s full name.Example: John Smith
string
required
Attendee’s email address for confirmation.Example: john@example.com
string
Attendee’s phone number.Example: +14155551234
string
Additional notes or reason for appointment.Example: Interested in dental cleaning
integer
Cal.com event type ID. Uses default if not specified.
string
default:"America/Los_Angeles"
Attendee’s timezone.

Response

integer
Cal.com booking ID.
string
Unique booking identifier.
string
Confirmed start time.
string
Confirmed end time.
string
Video meeting URL (if applicable).

AI Agent Booking Flow

Your AI agent can book appointments automatically during calls: