Skip to content

Zaptime Config

ts
interface ZaptimeConfig {
  token: string;
  apiBaseUrl?: string;
  min?: number;
  max?: number;
  closestBookableDay?: number;
  locale?: ZaptimeLocale;
  theme?: ZaptimeTheme;
  profileImage?: string;
  hideLocation?: boolean;
  compact?: boolean;
  externalBooking?: boolean;
  redirectAfterBookingUrl?: string;
  reservationUuid?: string;
  rescheduleOverrideToken?: string;
}
KeyTypeDefaultDescription
tokenstringRequired. Integration token of the event type (or group token with type: "group" in the script tag).
apiBaseUrlstringhttps://api.zaptime.app/API root, with trailing slash. Set only for staging or self-hosted APIs.
minnumberdashboardMonths backwards the visitor may navigate.
maxnumberdashboardMonths forwards the visitor may navigate.
closestBookableDaynumberdashboardDays from today before the first bookable date.
localeZaptimeLocaledashboardLanguage preset, weekday labels, texts.
themeZaptimeThemedashboardMode, radius, colors.
profileImagestringdashboardOrganizer avatar URL. "" hides it.
hideLocationbooleanfalseHide the location line (Google Meet, phone, address).
compactbooleanfalseSingle-column layout: date first, then time. Forced on below 860px viewport width.
externalBookingbooleanfalseStop after the slot selection; the host submits with book/reserve. See Working with Time Slots.
redirectAfterBookingUrlstringURL to navigate to after a successful booking.
reservationUuidstringPuts the calendar in reschedule mode for that reservation. See Rescheduling.
rescheduleOverrideTokenstringServer-issued proof that the visitor is the organizer; bypasses attendee reschedule policies.

Merge order

Values come from three layers, later ones win:

  1. Core defaults (English texts, basic theme).
  2. Remote configuration of the event type from the dashboard.
  3. The local config you pass.

The merge is deep and key by key. An empty string overrides too: locale.texts.introduction: "" hides the introduction text. Keep the local config minimal so that dashboard edits reach your site without a deploy.