Skip to main content
PATCH
Update a team event type

Authorizations

Authorization
string
header
required

Use the Authorization header with Bearer scheme.

Examples:

  • API Key: Authorization: Bearer calid_xxxxx

Path Parameters

teamId
integer
required

Numeric team identifier.

Required range: x > 1
Example:

42

eventTypeId
integer
required

Numeric team event type identifier.

Required range: x > 1
Example:

7

Body

application/json
title
string

Human-readable title for the event type shown in booking pages and calendars.

Required string length: 4 - 255
Example:

"30 Minute Discovery Call"

slug
string

Unique URL slug for the event type under the owner account.

Required string length: 4 - 100
Example:

"discovery-call-30"

description
string | null

Optional event type description shown to bookers.

Example:

"A short introductory call to discuss your goals and next steps."

interfaceLanguage
string | null

Interface language used for the booking experience.

Example:

"en"

position
integer
default:0

Sort position used when listing multiple event types.

Example:

0

locations
object[] | null

Location or conferencing configuration payload for this event type. Each item type must be one of the supported location type enum values.

Example:
length
integer
default:15

Meeting duration in minutes.

Required range: x >= 10
Example:

30

offsetStart
integer
default:0

Offset in minutes added to generated slot start times.

Example:

0

hidden
boolean
default:false

Whether the event type should be hidden from public listings.

Example:

false

timeZone
string | null

IANA timezone used when event type timezone is locked.

Example:

"Asia/Kolkata"

periodType
enum<string>
default:UNLIMITED

Availability period strategy for booking this event type.

Available options:
UNLIMITED,
ROLLING,
ROLLING_WINDOW,
RANGE
Example:

"UNLIMITED"

periodStartDate
string<date-time> | null

Start date-time boundary for limited booking windows.

Example:

"2026-05-01T00:00:00.000Z"

periodEndDate
string<date-time> | null

End date-time boundary for limited booking windows.

Example:

"2026-05-31T23:59:59.000Z"

periodDays
integer | null

Number of days allowed for period-based booking limits.

Example:

30

periodCountCalendarDays
boolean | null

Whether period day counting should use calendar-day boundaries.

Example:

true

requiresConfirmation
boolean
default:false

Whether new bookings require organizer confirmation.

Example:

false

requiresConfirmationWillBlockSlot
boolean
default:false

Whether pending confirmation should block the slot from other bookings.

Example:

false

requiresConfirmationForFreeEmail
boolean
default:false

Whether confirmation is enforced for bookers using free email domains.

Example:

false

requiresBookerEmailVerification
boolean
default:false

Whether the booker must verify email before finalizing booking.

Example:

false

recurringEvent
any

Recurring event configuration payload.

Example:
disableGuests
boolean
default:false

Whether attendees are prevented from adding guests.

Example:

false

hideCalendarNotes
boolean
default:false

Whether internal calendar notes are hidden from attendees.

Example:

false

hideCalendarEventDetails
boolean
default:false

Whether detailed calendar event metadata is hidden from attendees.

Example:

false

minimumBookingNotice
integer
default:120

Minimum notice in minutes required before a slot can be booked.

Required range: x >= 0
Example:

120

beforeEventBuffer
integer
default:0

Buffer time in minutes blocked before each booking.

Example:

0

afterEventBuffer
integer
default:0

Buffer time in minutes blocked after each booking.

Example:

0

seatsPerTimeSlot
integer | null

Maximum seats available per slot for seat-based events.

Example:

5

onlyShowFirstAvailableSlot
boolean
default:false

Whether only the first available slot should be displayed to bookers.

Example:

false

disableCancelling
boolean | null
default:false

Whether guests are prevented from cancelling bookings.

Example:

false

disableRescheduling
boolean | null
default:false

Whether guests are prevented from rescheduling bookings.

Example:

false

disableHostCancelling
boolean | null
default:false

Whether hosts are prevented from cancelling bookings for team events.

Example:

false

disableHostRescheduling
boolean | null
default:false

Whether hosts are prevented from rescheduling bookings for team events.

Example:

false

seatsShowAttendees
boolean | null
default:false

Whether seat-based events should show attendee details to other attendees.

Example:

false

seatsShowAvailabilityCount
boolean | null
default:true

Whether remaining seat availability count should be shown to bookers.

Example:

true

schedulingType
enum<string> | null

Scheduling strategy for owner/team assignment.

Available options:
ROUND_ROBIN,
COLLECTIVE,
MANAGED
Example:

"COLLECTIVE"

scheduleId
integer | null

Schedule identifier linked to this event type.

Example:

1

price
integer
default:0

Price amount in the smallest currency unit for paid events.

Example:

0

currency
string
default:usd

ISO currency code used when price is set.

Example:

"usd"

slotInterval
integer | null

Custom interval in minutes between suggested slots.

Example:

15

metadata
any

Arbitrary metadata payload stored with the event type.

Example:
successRedirectUrl
string<uri> | null

URL to redirect bookers to after successful booking.

Example:

"https://example.com/booking-success"

forwardParamsSuccessRedirect
boolean | null
default:true

Whether booking query parameters should be appended to the success redirect URL.

Example:

true

bookingLimits
any

Booking limits configuration payload.

Example:
durationLimits
any

Allowed duration limits configuration payload.

Example:
isInstantEvent
boolean
default:false

Whether this event type can be booked instantly for near-immediate meetings.

Example:

false

instantMeetingExpiryTimeOffsetInSeconds
integer
default:90

Number of seconds before an instant meeting offer expires.

Example:

90

assignAllTeamMembers
boolean
default:false

Whether all team members should be assigned for this event type.

Example:

false

assignRRMembersUsingSegment
boolean
default:false

Whether round-robin members should be selected using a segment query.

Example:

false

rrSegmentQueryValue
any

Segment query payload used for round-robin member assignment.

Example:
useEventTypeDestinationCalendarEmail
boolean
default:false

Whether destination calendar email should be derived from event type settings.

Example:

false

isRRWeightsEnabled
boolean
default:false

Whether weighted round-robin distribution is enabled.

Example:

false

maxLeadThreshold
integer | null

Maximum lead threshold used for assignment logic.

Example:

100

includeNoShowInRRCalculation
boolean
default:false

Whether no-show bookings should be included in round-robin calculations.

Example:

false

allowReschedulingPastBookings
boolean
default:false

Whether past bookings are eligible for rescheduling.

Example:

false

hideOrganizerEmail
boolean
default:false

Whether organizer email is hidden from attendees.

Example:

false

maxActiveBookingsPerBooker
integer | null

Maximum number of active bookings allowed per booker.

Example:

3

maxActiveBookingPerBookerOfferReschedule
boolean
default:false

Whether over-limit bookers should be offered reschedule instead of blocking.

Example:

false

customReplyToEmail
string<email> | null

Custom reply-to email used in booking communications.

Example:

"replyto@example.com"

eventTypeColor
any

Custom color settings for the event type.

Example:
rescheduleWithSameRoundRobinHost
boolean
default:false

Whether reschedules should keep the same round-robin host.

Example:

false

useBookerTimezone
boolean
default:false

Whether booking flow should prioritize the booker timezone.

Example:

false

restrictionScheduleId
integer | null

Schedule identifier used to restrict availability for this event type.

Example:

2

bookingFields
object[] | null

Full replacement list of user-managed booking fields.

Example:

Response

Team event type updated successfully

Team event type updated successfully

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