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;
}| Key | Type | Default | Description |
|---|---|---|---|
token | string | Required. Integration token of the event type (or group token with type: "group" in the script tag). | |
apiBaseUrl | string | https://api.zaptime.app/ | API root, with trailing slash. Set only for staging or self-hosted APIs. |
min | number | dashboard | Months backwards the visitor may navigate. |
max | number | dashboard | Months forwards the visitor may navigate. |
closestBookableDay | number | dashboard | Days from today before the first bookable date. |
locale | ZaptimeLocale | dashboard | Language preset, weekday labels, texts. |
theme | ZaptimeTheme | dashboard | Mode, radius, colors. |
profileImage | string | dashboard | Organizer avatar URL. "" hides it. |
hideLocation | boolean | false | Hide the location line (Google Meet, phone, address). |
compact | boolean | false | Single-column layout: date first, then time. Forced on below 860px viewport width. |
externalBooking | boolean | false | Stop after the slot selection; the host submits with book/reserve. See Working with Time Slots. |
redirectAfterBookingUrl | string | URL to navigate to after a successful booking. | |
reservationUuid | string | Puts the calendar in reschedule mode for that reservation. See Rescheduling. | |
rescheduleOverrideToken | string | Server-issued proof that the visitor is the organizer; bypasses attendee reschedule policies. |
Merge order
Values come from three layers, later ones win:
- Core defaults (English texts, basic theme).
- Remote configuration of the event type from the dashboard.
- The local
configyou 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.
