Update Calendar

PUThttps://services.leadconnectorhq.com/calendars/{calendarId}/free-slots
Request

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer 123
Path Parameters
calendarId
string
required

Calendar Id

Example:
ocQHyuzHvysMo5N5VsXc
Headers
Authorization
string
required

Access Token

Example:
Bearer 9c48df2694a849b6089f9d0d3513efe
Version
string
required

API Version

Allowed value:
2021-04-15
Body
notifications
array[object]
deprecated

🚨 Deprecated! Please use 'Calendar Notifications APIs' instead.

type
string

Calendar Notification

Allowed value:
email
Default:
email
Example:
email
shouldSendToContact
boolean
required
shouldSendToGuest
boolean
required
shouldSendToUser
boolean
required
shouldSendToSelectedUsers
boolean
required
selectedUsers
string
required

Comma separated emails

Example:
user1@testemail.com,user2@testemail.com
groupId
string

Group Id

Example:
BqTwX8QFwXzpegMve9EQ
teamMembers
array[object]

Team members are required for calendars of type: Round Robin, Collective, Class, Service. Personal calendar must have exactly one team member.

userId
string
required
Example:
ocQHyuzHvysMo5N5VsXc
priority
number
Allowed values:
00.51
Default:
0.5
isPrimary
boolean

Marks a user as primary. This property is required in case of collective booking calendars. Only one user can be primary.

locationConfigurations
array[object]

Meeting location configuration for event calendar.

  • Multiple locations are allowed only when one team member is selected.
  • For Class booking and Collective calendars, only one location configuration is allowed for each team member.
eventType
string
Allowed values:
RoundRobin_OptimizeForAvailabilityRoundRobin_OptimizeForEqualDistribution
name
string
Example:
test calendar
description
string
Example:
this is used for testing
slug
string
Example:
test1
widgetSlug
string
Example:
test1
widgetType
string

Calendar widget type. Choose "default" for "neo" and "classic" for "classic" layout.

Allowed values:
defaultclassic
Default:
classic
Example:
classic
eventTitle
string
eventColor
string
Default:
#039be5
locationConfigurations
array[object]

Meeting location configuration for event calendar

kind
string
required

Type of meeting location. zoom_conference/google_conference/ms_teams_conference is not supported in event calendar type

Allowed values:
customzoom_conferencegoogle_conferenceinbound_calloutbound_callphysicalbookerms_teams_conference
Example:
custom
location
string

Address for meeting location. Not applicable on "zoom_conference", "google_conference" and "ms_teams_conference" kind

Examples:
+14455550132http://meet.google.com/your-meeting-location
slotDuration
number

This controls the duration of the meeting

Default:
30
slotDurationUnit
string

Unit for slot duration.

Allowed values:
minshours
preBufferUnit
string

Unit for pre-buffer.

Allowed values:
minshours
slotInterval
number

Slot interval reflects the amount of time the between booking slots that will be shown in the calendar.

Default:
30
slotIntervalUnit
string

Unit for slot interval.

Allowed values:
minshours
slotBuffer
number

Slot-Buffer is additional time that can be added after an appointment, allowing for extra time to wrap up

preBuffer
number

Pre-Buffer is additional time that can be added before an appointment, allowing for extra time to get ready

appoinmentPerSlot
number
appoinmentPerDay
number

Number of appointments that can be booked for a given day

allowBookingAfter
number

Minimum scheduling notice for events

allowBookingAfterUnit
string

Unit for minimum scheduling notice

Allowed values:
hoursdaysweeksmonths
Example:
days
allowBookingFor
number

Minimum number of days/weeks/months for which to allow booking events

allowBookingForUnit
string

Unit for controlling the duration for which booking would be allowed for

Allowed values:
daysweeksmonths
Example:
days
openHours
array[object]
daysOfTheWeek
array[number]
required
hours
array[object]
required
enableRecurring
boolean

Enable recurring appointments for the calendars. Please note that only one member should be added in the calendar to enable this

Default:
false
recurring
object
freq
string
Allowed values:
DAILYWEEKLYMONTHLY
count
number

Number of recurrences

<= 24
bookingOption
string

This setting contols what to do incase a recurring slot is unavailable

Allowed values:
skipcontinuebook_next
bookingOverlapDefaultStatus
string

This setting contols what to do incase a recurring slot is unavailable

Allowed values:
confirmednew
formId
string
stickyContact
boolean
isLivePaymentMode
boolean
autoConfirm
boolean
shouldSendAlertEmailsToAssignedMember
boolean
alertEmail
string
googleInvitationEmails
boolean
allowReschedule
boolean
allowCancellation
boolean
shouldAssignContactToTeamMember
boolean
shouldSkipAssigningContactForExisting
boolean
notes
string
pixelId
string
formSubmitType
string
Allowed values:
RedirectURLThankYouMessage
Default:
ThankYouMessage
formSubmitRedirectURL
string
formSubmitThanksMessage
string
availabilityType
number

Determines which availability type to consider:

  • 1: Only custom availabilities will be used.
  • 0: Only open hours will be used.
  • null: Both the custom availabilities and open hours will be considered.
Allowed values:
01
availabilities
array[object]

This is only to set the custom availability. For standard availability, use the openHours property

date
string
required

Formulate the date string in the format of <YYYY-MM-DD in local timezone>T00:00:00.000Z.

Example:
2023-09-24T00:00:00.000Z
hours
array[object]
required
deleted
boolean
Default:
false
id
string

The ID of the custom availability object. It is required while updating or deleting the existing custom date availability

guestType
string
Allowed values:
count_onlycollect_detail
consentLabel
string
calendarCoverImage
string
lookBusyConfig
object

Look Busy Configuration

enabled
boolean
required

Apply Look Busy

Default:
false
Example:
true
LookBusyPercentage
number
required

Percentage of slots that will be hidden

isActive
boolean

Responses

calendar
object
required
isActive
boolean

Should the created calendar be active or draft

Default:
true
notifications
array[object]
deprecated

🚨 Deprecated! Please use 'Calendar Notifications APIs' instead.

locationId
string
required
Example:
ocQHyuzHvysMo5N5VsXc
groupId
string

Group Id

Example:
BqTwX8QFwXzpegMve9EQ
teamMembers
array[object]

Team members are for calendars of type: Round Robin, Collective, Class, Service. Personal calendar must have exactly one team member.

eventType
string
Allowed values:
RoundRobin_OptimizeForAvailabilityRoundRobin_OptimizeForEqualDistribution
Default:
RoundRobin_OptimizeForAvailability
name
string
required
Example:
test calendar
description
string
Example:
this is used for testing
slug
string
Example:
test1
widgetSlug
string
Example:
test1
calendarType
string
Allowed values:
round_robineventclass_bookingcollectiveservice_bookingpersonal
widgetType
string

Calendar widget type. Choose "default" for "neo" and "classic" for "classic" layout.

Allowed values:
defaultclassic
Default:
classic
Example:
classic
eventTitle
string
Default:
{{contact.name}}
eventColor
string
Default:
#039be5
meetingLocation
string
deprecated

🚨 Deprecated! Use locationConfigurations.location or teamMembers[].locationConfigurations.location instead.

locationConfigurations
array[object]

Meeting location configuration for event calendar

slotDuration
number

This controls the duration of the meeting

Default:
30
slotDurationUnit
string

Unit for slot duration.

Allowed values:
minshours
slotInterval
number

Slot interval reflects the amount of time the between booking slots that will be shown in the calendar.

Default:
30
slotIntervalUnit
string

Unit for slot interval.

Allowed values:
minshours
slotBuffer
number

Slot-Buffer is additional time that can be added after an appointment, allowing for extra time to wrap up

slotBufferUnit
string

Unit for slot buffer.

Allowed values:
minshours
preBuffer
number

Pre-Buffer is additional time that can be added before an appointment, allowing for extra time to get ready

preBufferUnit
string

Unit for pre-buffer.

Allowed values:
minshours
appoinmentPerSlot
number

Maximum bookings per slot (per user). Maximum seats per slot in case of Class Booking Calendar.

Default:
1
appoinmentPerDay
number

Number of appointments that can be booked for a given day

allowBookingAfter
number

Minimum scheduling notice for events

allowBookingAfterUnit
string

Unit for minimum scheduling notice

Allowed values:
hoursdaysweeksmonths
Example:
days
allowBookingFor
number

Minimum number of days/weeks/months for which to allow booking events

allowBookingForUnit
string

Unit for controlling the duration for which booking would be allowed for

Allowed values:
daysweeksmonths
Example:
days
openHours
array[object]

This is only to set the standard availability. For custom availability, use the availabilities property

enableRecurring
boolean

Enable recurring appointments for the calendars. Please note that only one member should be added in the calendar to enable this

Default:
false
recurring
object
formId
string
stickyContact
boolean
isLivePaymentMode
boolean
autoConfirm
boolean
Default:
true
shouldSendAlertEmailsToAssignedMember
boolean
alertEmail
string
googleInvitationEmails
boolean
Default:
false
allowReschedule
boolean
Default:
true
allowCancellation
boolean
Default:
true
shouldAssignContactToTeamMember
boolean
shouldSkipAssigningContactForExisting
boolean
notes
string
pixelId
string
formSubmitType
string
Allowed values:
RedirectURLThankYouMessage
Default:
ThankYouMessage
formSubmitRedirectURL
string
formSubmitThanksMessage
string
availabilityType
number

Determines which availability type to consider:

  • 1: Only custom availabilities will be used.
  • 0: Only open hours will be used.
  • null: Both custom availabilities and open hours will be considered.
Allowed values:
01
availabilities
array[object]

This is only to set the custom availability. For standard availability, use the openHours property

guestType
string
Allowed values:
count_onlycollect_detail
consentLabel
string
calendarCoverImage
string
Example:
https://path-to-image.com
lookBusyConfig
object

Look Busy Configuration

id
string
required
Example:
0TkCdp9PfvLeWKYRRvIz

Unprocessable Entity

Body

statusCode
number
Example:
422
message
array[string]
Example:
["Unprocessable Entity"]
error
string
Example:
Unprocessable Entity

Unauthorized

Body

statusCode
number
Example:
401
message
string
Example:
Invalid token: access token is invalid
error
string
Example:
Unauthorized

Bad Request

Body

statusCode
number
Example:
400
message
string
Example:
Bad Request