POST
/
v2
/
schedules

Headers

Authorization
string
required

value must be Bearer <token> where <token> either managed user access token or api key prefixed with cal_

cal-api-version
string
required

Must be set to 2024-06-11

Body

application/json
name
string
required
timeZone
string
required

Timezone is used to calculate available times when an event using the schedule is booked.

isDefault
boolean
required

Each user should have 1 default schedule. If you specified timeZone when creating managed user, then the default schedule will be created with that timezone. Default schedule means that if an event type is not tied to a specific schedule then the default schedule is used.

availability
object[]

Each object contains days and times when the user is available. If not passed, the default availability is Monday to Friday from 09:00 to 17:00.

overrides
object[]

Need to change availability for a specific date? Add an override.

Response

201 - application/json
status
enum<string>
required
Available options:
success,
error
data
object
required