Mindbody

Let your agent check availability and book, reschedule, or cancel appointments and classes in your Mindbody  account — booking software for fitness studios, gyms, salons, and spas.

Setup

1. Ask your Mindbody administrator to activate Ciaomatic for your site (the per-site authorization step in Mindbody).
2. Find your numeric Site ID in Mindbody under your business/site settings.
3. Create (or choose) a staff account the agent will book as, and note its username and password. Source-credential usernames carry a leading underscore (e.g. _studiostaff) — enter it exactly as Mindbody shows it.
4. Integrations → Add integration → Mindbody.
5. Name it (e.g. “Mindbody booking”).
6. Paste the Site ID, staff username, and password. The credentials are exchanged for a short-lived session token and stored encrypted, never shown again.
7. Optionally set default service (session type), staff, and location IDs so a call doesn’t have to specify them. Read these IDs with the list_offerings tool once connected.
8. Click Add & discover tools.

Tools

Once connected, the agent can (prefixed with your integration’s slug):

• …_list_offerings — list the business’s services (session types), staff, and locations (with their ids)
• …_get_available_times — open appointment times for a service (max 7 days ahead)
• …_create_appointment — book an appointment for an existing client (call find_client first to get the client id)
• …_reschedule_appointment — move an existing appointment to a new time
• …_cancel_appointment — cancel an appointment
• …_book_class — add a client to a scheduled class
• …_cancel_class — remove a client from a scheduled class (with a late-cancel flag)
• …_find_client — find an existing client by name, email, or phone

Enable the ones you want per agent version in the builder’s Integration tools card.

Booking flow

A Mindbody appointment needs a service, a staff member, a location, and an existing client. The first three come from list_offerings or your configured defaults; the client comes from find_client. The agent looks up the caller with find_client, then books with create_appointment. Class booking (book_class / cancel_class) works the same way against a scheduled class.

Cost note

Mindbody bills per API call (roughly $0.002 per call beyond the free tier). Ciaomatic keeps this low by caching the session token and the services/staff/ locations list for a few minutes per call; availability lookups, client searches, and every booking still go live so callers never see stale slots.