Skip to main content
POST
Create a booking

Authorizations

Authorization
string
header
required

Use the Authorization header with Bearer scheme.

Examples:

  • API Key: Authorization: Bearer calid_xxxxx

Body

application/json
start
string<date-time>
required

Booking start time (ISO 8601, e.g., '2025-10-09T14:30:00+05:30')

Example:

"2026-05-02T10:00:00.000Z"

end
string<date-time>
required

Booking end time (ISO 8601, e.g., '2025-10-09T15:00:00+05:30')

Example:

"2026-05-02T10:30:00.000Z"

responses
object
required

Booking form responses containing attendee details

Example:
eventTypeId
integer

Unique identifier for the event type

Required range: x > 1
Example:

12

eventTypeSlug
string

Event type slug selector. Accepted formats: <slug> for your own event type, <username>/<slug> (owner-prefixed user format), or team/<teamSlug>/<slug> for team event types.

Minimum string length: 1
Example:

"john-doe/discovery-call-30"

timeZone
string
default:Asia/Kolkata

IANA timezone identifier (e.g., 'Asia/Kolkata', 'America/New_York')

Example:

"Asia/Kolkata"

language
string
default:en

Language code for email communications (e.g., 'en', 'es', 'fr')

Example:

"en"

metadata
object

Additional metadata for the booking

Example:

Response

Booking created

Booking created

success
enum<boolean>
required
Available options:
true
data
object
message
string
meta
object