Field reference
Every field on every Calendar form: label in English and Arabic, type, whether it is required, its limits, a valid example and what the system refuses.
On this page (16)
Event form
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Title | العنوان | Text | Yes | Max 200 (screen stops at 200; server cuts longer text silently). Save is greyed out while empty | Weekly sales review | Only spaces (API) -> 'This is required.' | |
| Calendar | التقويم | Select | No | Only calendars you own or edit (My Calendar, shared calendars where you are editor, all shared ones with calendar.manage). Locked after creation. Empty = My Calendar | My Calendar | My Calendar | A shared calendar where you are only a viewer (API) -> 'You only read this calendar.' |
| Kind | النوع | Select | Yes | Meeting, Call, Task, Reminder, Out of office, Other ('Appointment' is made only by bookings). Kind Reminder defaults Show as to Free | Meeting | Call | 'party' (API) -> 'Choose one of: meeting, call, task, reminder, out_of_office, appointment, other.' |
| All day | طوال اليوم | Checkbox | No | On: From/To dates (whole local days, To inclusive) and no default reminder. Off: Starts/Ends date-times | Off | On | |
| From (all day) | من | Date | Yes | First local day; moving it past To moves To along | 2026-10-08 | Empty (API) -> 'Choose the first day.' | |
| To (all day) | إلى | Date | Yes | Last local day, inclusive; not before From | 2026-10-09 | 2026-10-07 with From 2026-10-08 (API) -> 'The event ends before it starts.' | |
| Starts | يبدأ | Date-time | Yes | Wall-clock time in the event's Time zone; changing it keeps the length (Ends moves along) | The clicked slot, else the working-day start | 2026-10-05 09:00 | 'tomorrow' (API) -> 'Use a date and time as YYYY-MM-DDTHH:MM.' |
| Ends | ينتهي | Date-time | No | After Starts; at most 60 days after it; empty = Starts + 'New events last' (default 60 min) | Starts + 60 min | 2026-10-05 10:00 | Same as Starts -> 'The event ends before it starts.'; 70 days long -> 'An event lasts at most 60 days; repeat it instead.' |
| Time zone | المنطقة الزمنية | Select | Yes | 12 zones on screen (Asia/Dubai, Riyadh, Qatar, Bahrain, Kuwait, Muscat, Karachi, Kolkata, London, Paris, New York, UTC); server accepts any IANA zone. Stored times are UTC | Your zone (else the company's, Asia/Dubai) | Asia/Dubai | 'Dubai' (API) -> 'Choose a time zone such as Asia/Dubai.' |
| Colleagues | الزملاء | Multi-select (people) | No | Active members of this company (yourself not listed); you are added as organiser 'accepted'; max 200 attendees in all; the 'Busy then:' line names colleagues busy at that time | Two colleagues | A user of another company (API) -> 'A colleague attendee must belong to this company.' | |
| Guests (e-mails) | الضيوف (البريد) | Text (list) | No | E-mails split by comma, semicolon or space; lower-cased; they get e-mail reminders only (no invitation e-mail) | guest1@example.com, guest2@example.com | 'abc' -> 'Enter a valid e-mail address.' | |
| Location | المكان | Text | No | Max 200 | Conference Room A, Floor 3 | ||
| Online meeting link | رابط الاجتماع عبر الإنترنت | URL | No | Max 500; must start with https:// or http://; pasted (no provider link is generated) | https://meet.example.com/sales-review | 'meet.example.com/x' -> 'An online link starts with https://.' | |
| Rooms and equipment | القاعات والمعدات | Multi-select (resources) | No | Only bookable (active) resources; shown only when the company has some; a clash with another live booking is refused (409) naming it | Conference Room A (12) | A room already booked 10:00-11:00 for 10:30-11:30 -> 'Conference Room A is already booked 2026-10-06 10:00 to 11:00 for “Client Meeting”.' | |
| Show as | يظهر | Select | Yes | Busy / Free; Free events do not count in free/busy, slot finding or busy hours | Busy (Free for kind Reminder) | Free | |
| Privacy | الخصوصية | Select | Yes | Normal / Private: others who read the calendar see only 'Busy' (no title, place, link, attendees) | Normal | Private | |
| Status | الحالة | Select | No | Confirmed / Tentative (cancelled only through Cancel event) | Confirmed | Tentative | 'cancelled' via edit (API) -> 'Choose one of: confirmed, tentative.' |
| Notes | ملاحظات | Text area | No | Max 20000 (cut silently) | Agenda: pipeline, Q4 targets |
Event form > Repeat
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Repeat | التكرار | Select | No | Does not repeat, Daily, Weekly, Monthly, Yearly. Locked when you edit one occurrence | Does not repeat | Weekly | 'hourly' (API) -> 'Repeat daily, weekly, monthly or yearly.' |
| every (interval) | كل | Integer | No | 1-99 | 1 | 2 | 0 (API) -> 'Enter a whole number between 1 and 99.' |
| Weekdays (weekly) | أيام الأسبوع | Checkboxes Mo-Su | No | Monday = 0 ... Sunday = 6; none ticked = the start's weekday | Mo, We | [7] (API) -> 'Choose the weekdays (Monday = 0).' | |
| Monthly on | شهريًا في | Select | No | on the same day (a month without that day is skipped, e.g. the 31st) / on the same weekday (nth weekday worked out from the start: day 1-7 = 1st ... 22-28 = 4th) | on the same day | on the same weekday (start Tue 13 Oct 2026 = 2nd Tuesday) | Same weekday with a start on the 29th-31st -> 'Choose the first to fourth, or the last, weekday.' (no 'last' choice on screen) |
| Ends (repeat) | ينتهي | Select | No | never ends (expanded 3 years ahead for room clashes) / ends after N times / ends on a date | never ends | ends after | Both count and until (API) -> 'End after a number of times or on a date, not both.' |
| times (count) | مرات | Integer | Conditional | 1-1000; skipped occurrences still count | 10 | 6 | 1001 (API) -> 'Enter a whole number between 1 and 1000.' |
| Until | حتى | Date | Conditional | Local date, inclusive; not before the first occurrence | Start + 30 days | 2026-12-31 | A date before the start -> 'The repeat ends before the first occurrence.' |
Event form > Reminders
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Reminder: when | متى | Select | No | at the start, 5, 10, 15, 30 min, 1 h, 2 h, 1 day before (API 0-40320 minutes); up to 5 reminders; a duplicate minutes+channel pair is dropped | Default reminder from settings (15 min) for a timed event, none for all-day | 30 min before | 6 reminders (API) -> 'At most five reminders.'; 50000 -> 'Enter a whole number between 0 and 40320.' |
| Reminder: how | كيف | Select | No | Notification (bell) / E-mail (from the organiser's mail account) | Notification | 'sms' (API) -> 'Choose one of: notification, email.' |
Event dialog
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Going? | هل ستحضر؟ | Buttons | No | Yes (accepted) / Maybe (tentative) / No (declined); only for an invited person who is not the organiser; answers the whole series | Yes | Answer an event you are not invited to (API) -> 'You are not invited to this event.' |
Calendar > Time zone
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Time zone (yours) | المنطقة الزمنية | Select | No | Company (<zone>) or one of 12 zones; draws every screen in that zone; empty = company zone | Company (Asia/Dubai) | Europe/London | 'Mars/Base' (API) -> 'Choose a time zone such as Asia/Dubai.' |
Calendar > Search
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Search events | بحث في الأحداث | Text | No | Matches title, location and notes (first 80 characters); others' private events never match; layers are hidden while searching | review |
Calendar > Filters
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Kind | النوع | Select | No | Any or one kind; layers hidden while a kind is chosen | Any | Meeting | |
| Events I am invited to | الأحداث المدعو إليها | Checkbox | No | Off hides events you attend that sit in calendars you do not read | On | Off |
Appointment type
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code | الرمز | Text | Yes | New only; max 30; upper-cased; unique per company | CONSULT | An existing code -> 'Another appointment type has this code.'; empty -> 'This is required.' | |
| Name | الاسم | Text | Yes | Max 120; shown on the public page | Consultation | Empty -> 'This is required.' | |
| Name (Arabic) | الاسم بالعربية | Text | No | Max 120 | استشارة | ||
| What it is (shown on the page) | الوصف | Text area | No | Max 1000 | A 30-minute meeting about your project. | ||
| Minutes | الدقائق | Integer | Yes | 5-480 (duration) | 30 | 30 | 500 -> 'Enter a whole number between 5 and 480.' |
| A slot every (min) | فترة كل (د) | Integer | Yes | 5-480; slots start every step from the window start | 30 | 30 | 4 -> 'Enter a whole number between 5 and 480.' |
| Buffer before (min) | فاصل قبل | Integer | No | 0-240; the slot plus buffers must miss busy time | 0 | 0 | 300 -> 'Enter a whole number between 0 and 240.' |
| Buffer after (min) | فاصل بعد | Integer | No | 0-240 | 0 | 15 | -5 -> 'Enter a whole number between 0 and 240.' |
| Book at least (hours ahead) | الحجز قبل (ساعات) | Integer | No | 0-720 (minimum notice); counts from now | 2 | 4 | 800 -> 'Enter a whole number between 0 and 720.' |
| Book up to (days ahead) | حتى (أيام) | Integer | No | 1-365 (horizon); the public page shows at most 21 days | 30 | 30 | 0 -> 'Enter a whole number between 1 and 365.' |
| Customer may cancel until (hours before) | الإلغاء حتى (ساعات قبل) | Integer | No | 0-720; applies to the manage link only (staff can always cancel) | 24 | 24 | 721 -> 'Enter a whole number between 0 and 720.' |
| Who takes these | من يستقبلها | Multi-select (people) | Conditional | Members of this company; required before publishing; a booking goes to the free person with the fewest bookings of this type that day | Two staff members | Publish with nobody -> 'Name who takes these appointments before publishing.'; another company's user (API) -> 'Staff must belong to this company.' | |
| Room or equipment | القاعة أو المعدات | Select (resource) | No | Optional; its bookings remove slots and every appointment books it | — | Meeting room 1 | An unknown id (API) -> 'Resource not found.' |
| Location | المكان | Text | No | Max 200; shown on the page and in e-mails | Main office, Dubai | ||
| Online | عبر الإنترنت | Checkbox | No | Page shows 'Online' when no location | Off | On | |
| Confirmation | التأكيد | Select | Yes | Booked = confirmed (auto) / Staff confirm (manual: a public booking is 'requested' and its event tentative; a staff booking is always confirmed) | Booked = confirmed | Staff confirm | |
| Closed on public holidays | مغلق في العطل | Checkbox | No | Full-day holidays of the HR working calendars remove the day (half days stay open) | On | On | |
| Public booking page | صفحة حجز عامة | Checkbox | No | On = the type card shows Booking page / Copy link; off = the link answers 'Booking page not found' | Off | On | |
| Active | نشط | Checkbox | No | Off: not offered in Book appointment; public link not found; booking refused | On | On | Book an inactive type (API) -> 'This appointment type is closed.' |
| Opening hours (per weekday) | ساعات العمل | Text per day | No | Monday-Sunday, windows like 09:00-12:00, 13:00-17:00; windows may not overlap; empty day = closed. New type default Mon-Fri 09:00-17:00 (UAE weekend Sat-Sun) | Mon-Fri 09:00-17:00 | 09:00-13:00, 14:00-17:00 | '12:00-09:00' -> 'A window ends before it starts.'; '09:00-12:00, 11:00-13:00' -> 'Two windows of one day overlap.'; '9-12' -> 'Use a time as HH:MM.' (screen: 'Write hours like 09:00-12:00.') |
Book an appointment
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Type | النوع | Select | Yes | Active types only | First active type | Consultation (30 min) | |
| Day | اليوم | Date | Yes | Today or later; slots respect notice, horizon, holidays, staff busy time, the room | Today | Next Monday | |
| Free times | الأوقات المتاحة | Pills | Yes | Only free slots; 'No free time this day.' when none | 10:30 | A slot taken meanwhile -> 'That time is no longer available. Choose another slot.' | |
| Customer name | اسم العميل | Text | Yes | Max 160 (cut); Book is greyed out while empty | Test Customer One | Empty (API) -> 'This is required.' | |
| البريد | No | Optional for staff bookings; when given the customer gets a confirmation e-mail with the manage link and, if more than 25 h ahead, an e-mail reminder 1 day before | customer1@example.com | 'abc' -> 'Enter a valid e-mail address.' | |||
| Phone | الهاتف | Text | No | Max 40 (cut), no format check | +971500000001 | ||
| Notes | ملاحظات | Text area | No | Max 1000; copied to the event notes | First visit |
Appointment card > Cancel
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Why is it cancelled? | سبب الإلغاء؟ | Prompt | Yes | Max 300; an empty prompt does nothing | Customer asked to move | Empty reason (API) -> 'This is required.' |
Resource
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code | الرمز | Text | Yes | New only; max 30; upper-cased; unique per company | CONF-A | An existing code -> 'Another resource has this code.' | |
| Name | الاسم | Text | Yes | Max 120; named in clash messages | Conference Room A | Empty -> 'This is required.' | |
| Name (Arabic) | الاسم بالعربية | Text | No | Max 120 | قاعة الاجتماعات أ | ||
| Kind | النوع | Select | Yes | Room, Equipment, Vehicle, Other | Room | Equipment | 'desk' (API) -> 'Choose one of: room, equipment, vehicle, other.' |
| Seats | المقاعد | Integer | No | 0-10000; information only (not checked against attendees) | 0 | 12 | 20000 -> 'Enter a whole number between 0 and 10000.' |
| Where | المكان | Text | No | Max 160 | Floor 3 | ||
| Colour | اللون | Text | No | #RRGGBB | #64748b | #0d9488 | 'teal' -> 'Use a colour like #2563eb.' |
| Notes | ملاحظات | Text area | No | Max 500 | Has a screen and video bar | ||
| Bookable | قابل للحجز | Checkbox | No | Off: not offered on events, left out of the schedule and reports; booking it refused | On | On | Book an inactive room (API) -> '<name> is not bookable now.' |
Calendar settings
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Company time zone | المنطقة الزمنية للشركة | Select | Yes | 12 zones on screen; default for people without their own zone and for new appointment types | Asia/Dubai | Asia/Dubai | 'GMT+4' (API) -> 'Choose a time zone such as Asia/Dubai.' |
| Week starts on | بداية الأسبوع | Select | Yes | Monday / Saturday / Sunday on screen (API 0-6, Monday = 0); first column of Month, Week and mini-month | Monday | Sunday | 9 (API) -> 'Enter a whole number between 0 and 6.' |
| Working day starts (HH:MM) | بداية الدوام | Text | Yes | HH:MM; before the end; where Week/Day scroll to and new events start; open hours for utilisation | 09:00 | 08:30 | '25:00' -> 'Use a time as HH:MM.'; 19:00 with end 18:00 -> 'The working day ends before it starts.' |
| Working day ends (HH:MM) | نهاية الدوام | Text | Yes | HH:MM; after the start | 18:00 | 17:30 | '6pm' -> 'Use a time as HH:MM.' |
| New events last (minutes) | مدة الحدث الجديد | Integer | Yes | 5-1440 | 60 | 30 | 2 -> 'Enter a whole number between 5 and 1440.' |
| Default reminder (minutes before; 0 = none) | التذكير الافتراضي | Integer | Yes | 0-10080; put on new timed events as a bell reminder | 15 | 10 | 20000 -> 'Enter a whole number between 0 and 10080.' |
Shared calendar
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code | الرمز | Text | Yes | New only; max 40; upper-cased; unique per company | SALES | An existing code -> 'Another calendar has this code.' | |
| Name | الاسم | Text | Yes | Max 120 | Sales | Empty -> 'This is required.' | |
| Name (Arabic) | الاسم بالعربية | Text | No | Max 120; shown when the screen is in Arabic | المبيعات | ||
| Colour | اللون | Text | No | #RRGGBB | #16a34a | #7c3aed | 'purple' -> 'Use a colour like #2563eb.' |
| Who reads it | من يقرؤه | Select | Yes | Everybody in the company (all members read) / Its members only | Everybody in the company (screen); members (API default) | Its members only | |
| Members who read | أعضاء للقراءة | Multi-select | No | Company members; a person in both lists becomes editor | One colleague | A user of another company (API) -> 'A member must belong to this company.' | |
| Members who add and change events | أعضاء للتعديل | Multi-select | No | Editors add, change and cancel events in this calendar | One colleague | ||
| About | الوصف | Text area | No | Max 500 | Sales team meetings | ||
| Active | نشط | Checkbox | No | Off: no longer listed for anybody (its events stay) | On | On |
Reports
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Month | الشهر | Month | No | First to last day of the chosen month, in your zone; not shown on Upcoming appointments | This month | 2026-10 |
Public booking page
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Choose a day | اختر يومًا | Day links | Yes | Today + up to 21 days (or the horizon if shorter); a full day is dashed; the first free day is chosen | The first free day | ||
| Time (slot) | الوقت | Radio | Yes | Free slots of the chosen day only | 10:00 | A slot booked meanwhile -> 'That time is no longer available. Choose another slot.' | |
| Your name | اسمك | Text | Yes | Max 160 | Test Customer Two | Empty (form post) -> 'This is required.' | |
| البريد الإلكتروني | Yes | Required on the public page; at most 3 upcoming live bookings per e-mail and type | customer2@example.com | 'abc' -> 'Enter a valid e-mail address.'; a 4th upcoming booking -> 'You already have three bookings of this kind coming up.' | |||
| Phone | الهاتف | Tel | No | Max 40 | +971500000002 | ||
| Anything we should know | ملاحظات | Text area | No | Max 1000 | Please call on arrival | ||
| Website (hidden honeypot) | الموقع (مخفي) | Hidden text | No | Invisible to people; a value means a bot | (empty) | (leave empty) | Any value -> 'This request was not accepted.' |
Customer manage page
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Reason (optional) | السبب (اختياري) | Text | No | Max 300; empty = 'Cancelled by customer' | Travelling | Inside the notice window -> 'It can be cancelled online up to 24 hours before it starts; please call us.' |