EasyWeek

List bookings of the workspace, paginated (`data[]` + `meta{page, per_page, total, has_more}`), newest first. Each booking has `uuid`, `starts_at`/`ends_at` (the location's local time with offset), `timezone`, `duration_minutes`, `customer`, `status`, `is_canceled`, `is_completed`. `date_from`/`date_to` are inclusive calendar days at the location (one day: the same day twice). Filters combine with AND: "Anna's bookings on Friday" = staffer_uuid + date_from = date_to = that Friday; "what is left today" = state 'upcoming' + today.

list_bookings

Replace the booked service with another catalog service (e.g. haircut -> haircut and beard). Duration and price follow the new service.

replace_booking_service

Move a booking to a new start time. Customer, services and payment stay; only the time changes. Pick the new slot with get_availability first and pass its `starts_at` as it is. The new time must be in the future (422 otherwise) and free on the staff member's calendar. The customer is notified unless send_notification is false.

reschedule_booking

Replace the comment on a booking. Staff see it in the calendar and it appears in the customer's notifications. Pass an empty string to remove the comment.

update_booking_notes

Create a customer card. The phone must be unique in the workspace: the API returns a validation error if it exists, so call find_customer first.

create_customer

Find customers by phone or email (at least one). Returns matching cards with `uuid`, name and contacts. Use it to resolve a customer before get_customer_bookings, create_order or update_customer, and before create_customer to avoid duplicates.

find_customer

Get full customer details: name, phone, email, birthday, company info, and messaging contacts.

get_customer

Get booking history for a customer, paginated, sorted by date descending (newest first).

get_customer_bookings

List customers in the workspace, paginated, with names, contacts, and profile fields.

list_customers

Update fields of a customer card. Only the fields you pass are changed; omitted fields keep their value.

update_customer

List products (goods) of the workspace with prices, units and stock flags. Needed for goods lines in create_order.

list_goods

Get address, contact details, `timezone` (IANA name, e.g. 'Europe/Berlin') and settings of one location.

get_location

List all locations (branches) of the company. Returns location UUIDs, names, addresses, and contact details. Location UUIDs are required for most other tools.

list_locations

Check whether a phone number can receive SMS before saving it on a customer card. Returns `valid` (bool), `reason` ('ok', 'invalid_number' or 'not_sms_capable'), `type` (MOBILE, FIXED_LINE...), `country_code`, `e164`.

check_phone

Messages sent to customers (reminders, notifications) on a window of calendar days (both inclusive), newest first, paginated (`data[]` + `meta{page, per_page, total, has_more}`). Each entry has `id`, `channel`, `to`, `customer_full_name`, `customer_uuid`, `reminder_type`, `status`, `sent_at` (the workspace's local time with offset), `error_message`, `pcs` (billed parts). Same report as Promote > Reminders > Reports.

get_message_history

One sent message by its `id` from get_message_history: delivery status, error (if any) and the rendered text.

get_message_status

Messaging wallets of the workspace: `wallets` (balance per channel: sms, whatsapp, viber...), `balance_limits` (low-balance alert thresholds) and `autoreload` per wallet (is_enabled, threshold, reload).

get_messaging_balance

Create an open point-of-sale order (a sale at the desk). Pass at least one of services, goods or vouchers. Line prices are in minor currency units as returned by list_services / list_goods (`price`). The order stays 'open' until pay_order; for a sale tied to a booking use complete_booking instead.

create_order

Get one order with its lines, discounts, payment method and linked bookings.

get_order

List point-of-sale orders with status, totals, customer and lines, paginated (`meta.has_more`), newest first. `date_from`/`date_to` keep the orders created on those calendar days (both inclusive); `created_at` is local time with offset.

list_orders

Mark an open order as paid through a payment account. Orders linked to bookings are paid via complete_booking instead.

pay_order

Refund a paid order: voids the invoice and reverses the sale. Irreversible, confirm with the user first. Only 'paid' orders whose invoice is settled can be refunded (409 otherwise); an order is refunded at most once.

refund_order

Turn a reminder on. It must already have a channel; set one with update_reminder_template first.

enable_reminder

Reminder templates of this workspace waiting for EasyWeek moderation (`uuid`, `channel`, `type`, submitted texts). Empty list = nothing pending.

get_moderation_status

Templates of a reminder: `templates` keyed by channel (sms, whatsapp, push...), each a list per locale with the current or default text. Read it before update_reminder_template and send back the same shape.

get_reminder_templates

Automatic reminders of the workspace: `uuid`, `type` (new_booking, before_visit, booking_canceled, thank_you_message...), `status` (active/paused), `channel` key and `on_moderation`. Start here for enable_reminder, pause_reminder and templates.

list_reminders

Pause a reminder: nothing is sent until it is enabled again.

pause_reminder

Set the channel and texts of a reminder and activate it. Returns `on_moderation` and the stored templates. A custom SMS/Viber/Telegram/Push text is held for EasyWeek moderation before it is sent (same as the dashboard); WhatsApp accepts only approved Meta template ids. Locales must be locales of the workspace.

update_reminder_template

Create a service in the workspace catalog. Attach it to locations and staff so it becomes bookable.

create_service

Get one service with `price`, `sale_price`, `duration_minutes`, category, locations and assigned staff. Read it before update_service.

get_service

List payment accounts (cash, card, online) configured for a location.

list_payment_accounts

List service categories at a location. Use to group services when displaying to users.

list_service_categories

List services offered at a location. Each service has `uuid`, `name`, `duration_minutes`, `pause_minutes`, `price` in minor currency units (e.g. 2500 = 25.00) with `currency`, `sale_price` while a discount runs, `price_is_from`, category and assigned staff.

list_services

Update a service. Name, duration and price are always required: call get_service first and resend the current values you keep.

update_service

Working hours of one staff member at one location, one entry per calendar day of the window. Each day lists its working intervals (start, end as HH:MM in the location's timezone, '24:00' = midnight) and is_day_off; an empty list means the staff member does not work that day. Weekly rules from the panel are expanded, a day set by date overrides them. Free slots for a booking come from get_availability, not from here.

get_staff_schedule

List staff members working at a location with their roles and assigned services.

list_staff

List staff categories (departments/roles) configured at a location.

list_staff_categories

Make one day a day off for one staff member at one location; nothing can be booked with them that day. One call = one staff member, one day. Bookings already on that day stay: list them with list_bookings first and reschedule or cancel them yourself. To work that day again, call set_staff_working_hours for the date.

set_staff_day_off

Replace the working hours of one staff member on one day: open a day, end it earlier, add a break. One call = one staff member, one day, one location; repeat per day. The day's previous hours, or a day off on that date, are replaced. Bookings already on that day are not moved or cancelled: check list_bookings for the day first and move them with reschedule_booking if they no longer fit.

set_staff_working_hours

Create a gift voucher template that staff (and optionally clients online) can sell.

create_voucher_template