Mindbodyonline Mindbody Public API
★ Only Publicly Available OpenAPI DocumentHealthcareAppointment SchedulingapiKey, bearer142 EndpointsREST
For Agents
Read and write Mindbody studio data — appointments, classes, clients, sales, enrollments, payroll, and staff — using API-Key, SiteId, and staff bearer authentication.
Use for: List the bookable appointment slots at a Mindbody studio next week, Get the active appointment add-ons configured at the site, Find available class times for a specific class description, Retrieve a client's visit history at a Mindbody site
Not supported: 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.
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.
Install Jentic One Beta
Connect the Mindbody Public API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Mindbody Public API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Mindbody Public API.
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
Patterns agents use Mindbody Public API for, with concrete tasks.
★ 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.
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.
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.
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.
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 the Jentic vault and the right combination is injected at execution time, including running /usertoken/issue when a staff token is required.
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
142 endpoints — jentic publishes the only available openapi specification for mindbody public api, keeping it validated and agent-ready.
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
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
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Mindbody's three credentials — developer API-Key, SiteId, and staff bearer token — are stored encrypted in the Jentic vault (MAXsystem). Jentic adds the correct headers to every call and can run /usertoken/issue automatically to refresh staff tokens, so raw credentials never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'list bookable appointments at a mindbody site') and Jentic returns the matching Mindbody operation with its input schema, so the agent calls GET /appointment/bookableitems without parsing the developer portal.
Time to first call
Direct Mindbody integration: 3-5 days to handle the multi-header auth, staff token lifecycle, and per-site quirks. Through Jentic: 1-2 hours — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Mindbody Public API through Jentic.
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 at https://app.jentic.com/sign-up.
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.
GET STARTED