BookHive

Book a client. First call without preview_id returns a preview to show the user; after they confirm, call again with the same arguments and the preview_id. Re-checks the time is still free.

create_appointment

Start here. The connected business, its timezone and today's date, the user's role and what it allows, and today's booking counts.

get_business_overview

Cancel an appointment with a reason. Preview first, then call again with preview_id after the user confirms. The client is not notified automatically.

cancel_appointment

Free start times for a service on a day, per professional, honouring schedules, existing bookings, time off, rooms and couple services. Use before create_appointment or reschedule_appointment.

find_available_slots

Appointments (bookings) in a date range, ordered by time, with client, service, professional, status, price and payment status. Cancelled ones are hidden unless status=cancelled.

list_appointments

Active professionals (staff), optionally only those who perform a service.

list_staff

Active services with service_id, category, price (whole units of the business currency, given in `currency`), duration and how many professionals each needs.

list_services

Move a pending or confirmed appointment to a new time (and optionally professional). Preview first, then call again with preview_id after the user confirms.

reschedule_appointment

A day's collected payments by method, tips, and bookings still unpaid. Needs a role that can see payments.

get_sales_summary

Find clients by part of the name or phone. Returns up to 10 with partly hidden contact details.

search_customers