Parameters
JSON body
Request body
application/jsoncodestringRequiredExternal calendar code identifier.
namestringOptionalCalendar display name.
colorstringOptionalCalendar hex color (e.g., "#FF5733").
timezonestringOptionalCalendar timezone (e.g., "Europe/Prague").
publicDescriptionstring | nullOptionalPublic description shown to customers.
internalDescriptionstring | nullOptionalInternal note (not shown to customers).
emailDescriptionstring | nullOptionalDescription included in email notifications.
emailDescriptionTranslationsobjectOptionalPer-locale e-mail description keyed by locale code (e.g. {"en": "…", "uk": "…"}). {{ calendarEmailDescription }} returns the text in the recipient's locale; an empty value falls back to emailDescription. Only the listed locales change; each must be enabled for the organisation.
defaultLocationTitlestring | nullOptionalDefault location title for new events.
productIdnumber | nullOptionalLinked product ID.
variantIdnumber | nullOptionalLinked product variant ID.
lockIdnumber | nullOptionalExternal TTLock identifier of the smart lock to bind to this calendar (matches iot__ttlock_lock.lock_id and the /iot-lock/[lockId] admin route). null unlinks the current lock. The lock must belong to the same organisation.
settingsPublicDescriptionstring | nullOptionalPublic description in settings context.
settingsInternalDescriptionstring | nullOptionalInternal description in settings context.
onlineChangeDeadlinestringOptionalDeadline for online changes (ISO duration or similar).
reserveFromstringOptionalEarliest time customers can reserve.
reserveUntilstringOptionalLatest time customers can reserve.
timeSlotIntervalstringOptionalTime slot interval for the booking grid.
lateCancelEnabledbooleanOptionalAllow late cancellation without refund between onlineChangeDeadline and lateCancelMinBefore before the start.
lateCancelMinBeforestringOptionalLatest point before the start when a late cancellation is still allowed (relative time, e.g. "2h").
accessCodeNotifyBeforestring | nullOptionalHow long before the start the reservation reminder (access-code e-mail) is sent, e.g. "10m". Overrides the notifyBefore sent by the website; null = use the website value.