canonical: https://jentic.com/apis/mindbodyonline.com/mindbodyonline # Mindbodyonline Mindbody Public API Jentic publishes the only available OpenAPI specification for Mindbody Public API, keeping it validated and agent-ready. The Mindbody Public API v6 is the integration surface for fitness, wellness, and beauty studios using the Mindbody platform; its 142 endpoints cover appointments, classes, clients, enrollments, payroll, sales, site configuration, and staff. Authentication combines a developer API-Key header, a SiteId header that targets the studio, and a bearer staff user token issued via /usertoken/issue for actions that require a signed-in operator. ## For AI agents Read and write Mindbody studio data - appointments, classes, clients, sales, enrollments, payroll, and staff - using API-Key, SiteId, and staff bearer authentication. ## Scope Does not handle payment processing networks, tax filing, or hardware (POS terminals) management - use for Mindbody studio operations (appointments, classes, clients, sales, payroll, staff, site config) only. ## Capabilities - Look up bookable items and active staff schedules to drive client booking flows - Read and create class enrollments and appointment bookings on behalf of clients - Pull client profiles, visit history, and account balances for support agents - Retrieve sales and payroll data for finance reporting and reconciliation jobs - Inspect a studio's site configuration including services, locations, and pricing - Manage staff schedules, unavailabilities, and appointment options across the site - Issue a staff user token via /usertoken/issue to authorise privileged operations ## Use cases ### Client Self-Service Booking An agent surfaces bookable appointment and class slots from Mindbody to a client-facing chatbot or website, then creates the booking on the client's behalf. The studio sees the new booking appear directly in Mindbody alongside walk-in and front-desk bookings. Example prompt: Call GET /appointment/bookableitems for a date range, present matching slots to the client, then book the chosen slot using the appropriate appointment-creation endpoint. ### Studio Operations Dashboard Operators centralise multi-site reporting by pulling appointments, classes, sales, and payroll out of Mindbody for each SiteId. The dashboard refreshes nightly so studio managers see the same numbers as the Mindbody back office without logging in. Example prompt: For each SiteId, fetch yesterday's sales and payroll endpoints and roll the totals into a multi-site dashboard. ### Staff Scheduling and Coverage An agent reads a studio's available dates, schedule items, and staff appointments to spot coverage gaps and suggest shift swaps. The studio manager validates and applies changes inside Mindbody, with the agent acting as the analysis layer. Example prompt: Pull GET /appointment/availabledates and GET /appointment/staffappointments for next week, then flag time blocks where bookable demand exceeds staffed hours. ### Personalised Client Outreach Marketing agents pair client visit history from Mindbody with a messaging tool to send win-back or upsell messages targeted at the right cohort. Mindbody supplies the source-of-truth on who came in, when, and what they bought. Example prompt: Pull clients with no visits in the last 60 days, build a SMS list, and trigger a win-back campaign in the connected messaging tool. ### Agent-Driven Studio Operations via Jentic Through Jentic, an agent calls Mindbody operations by intent rather than wrestling with three-header auth (API-Key + SiteId + staff bearer). The credentials sit in your Jentic One instance and the right combination is injected at execution time, including running /usertoken/issue when a staff token is required. Example prompt: Use Jentic search 'list bookable appointments at a mindbody site', load the schema for GET /appointment/bookableitems, and execute with the SiteId and date range. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | /appointment/bookableitems | Get appointment availabilities for booking | | GET | /appointment/scheduleitems | Get schedule items including appointments and unavailabilities | | GET | /appointment/staffappointments | Get appointments by staff member | | GET | /appointment/availabledates | Get dates staff are scheduled to work | | GET | /appointment/appointmentoptions | Get appointment configuration options | | GET | /appointment/activesessiontimes | Get active business hours for studios | ## Key resources - **Appointments** — Read and create appointments, schedule items, and staff availability - **Classes** — Manage class descriptions, schedules, and enrollments - **Clients** — Read and update client profiles, visits, and account data - **Sales** — Retrieve sales transactions and product data - **Payroll** — Read payroll records for staff reporting - **Site** — Inspect site configuration: services, pricing, locations - **Staff** — Manage staff records, schedules, and user tokens ## Why Jentic - **Setup:** Wiring Mindbody by hand means juggling three credentials, the developer API-Key and SiteId headers plus a staff bearer token, and refreshing that token yourself against api.mindbodyonline.com. Through Jentic you install once, import Mindbody from the API Directory, store the credentials once, and your agent calls it. - **Permission scoping:** Many Mindbody operations carry the site and target ids in headers or the request body rather than the URL path, so scope the agent to the operations it needs, such as reading bookable appointments or schedule items. You choose which operations are allowed, so a sale or payroll write is only included if you add it. - **Credential handling:** Your Mindbody API-Key, SiteId, and staff bearer token are stored once, encrypted, by your own Jentic One instance and injected as the correct headers at execution time. They never enter the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'list bookable appointments at a Mindbody site' or 'find a client', and Jentic returns the matching Mindbody operation with its input schema so the agent calls GET /appointment/bookableitems without parsing the developer portal. ## Related APIs - **Acuity Scheduling API** — Lighter-weight appointment booking platform popular with solo wellness practitioners. - **Calendly API** — General-purpose meeting scheduling for one-on-one and round-robin bookings. - **Fitbit Web API** — Wearable activity data that pairs with studio attendance for member engagement. ## FAQ ### Why is there no official OpenAPI spec for Mindbody Public API? Mindbody publishes documentation at developers.mindbodyonline.com but not an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Mindbody Public API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Mindbody Public API use? Each request requires the developer API-Key header and a SiteId header that identifies the studio. Operations that act on behalf of a staff user also require a bearer token issued by /usertoken/issue. Through Jentic, all three credentials live in the vault and are injected per request without entering the agent's context. ### Can I list bookable appointment slots through the API? Yes. GET /appointment/bookableitems returns availabilities for booking appointments at the configured SiteId, which is the supported way to power a custom booking surface that mirrors the Mindbody calendar. ### What are the rate limits for the Mindbody Public API? Mindbody enforces per-developer-key and per-site rate limits documented at developers.mindbodyonline.com. Expect a 429 response when limits are hit; back off and retry, and contact Mindbody for higher tiers if a single site needs heavier integration traffic. ### How do I issue a staff user token through Jentic? Run pip install jentic, search for 'issue a mindbody staff user token', load the schema for POST /usertoken/issue, and execute with the staff username and password. Jentic stores the resulting token alongside the API-Key and SiteId for downstream calls. ### Does this API let me manage multiple studios? Yes. The SiteId header selects the target studio per request, so a single API-Key can drive operations across every Mindbody site that has authorised the developer account. ### Can I limit what my agent is allowed to do with the Mindbody Public API? Yes. Because Jentic One is self-hosted, you decide which Mindbody operations the agent may call, so you can allow read-only calls like GET /appointment/bookableitems and GET /appointment/scheduleitems while excluding sales or payroll writes. Many Mindbody operations pass the SiteId and target ids in headers or the request body rather than the URL path, so scoping happens at the operation level under your own rules. A privileged action, such as issuing a staff token via /usertoken/issue or writing a sale, is only reachable if you add it to the allowed set. Your API-Key, SiteId, and staff bearer token stay in your Jentic One instance and are injected at execution time, never in the agent's context.