Mindbody is a business management and consumer marketplace platform for the fitness, beauty, and wellness industries, providing scheduling, point of sale, client management, marketing, and reporting tools for studios, gyms, salons, and spas. The Mindbody Public API (v6) provides REST endpoints for appointments, classes, clients, enrollments, sales, sites, staff, payroll, and cross-site identity, and is paired with a Webhooks API that pushes real-time event notifications using API key + SiteId headers, with optional OAuth 2.0 bearer tokens from the Mindbody Identity Service for staff- and client-scoped operations.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Fitness, Wellness, Beauty, Scheduling, Booking, Point of Sale, Studios, Salons, Spas, Webhooks
- Created: 2026-05-11
- Modified: 2026-05-28
REST API for Mindbody business data including appointments, classes, clients, enrollments, sales, sites, staff, payroll, pick-a-spot reservations, and cross-site identity. Authentication combines a Mindbody-issued API-Key header and SiteId header with optional OAuth 2.0 bearer tokens issued by Mindbody Identity Service for staff- and client-scoped operations. Base URL: https://api.mindbodyonline.com.
Human URL: https://developers.mindbodyonline.com/PublicDocumentation/V6
Base URL: https://api.mindbodyonline.com
- REST, OAuth 2.0, API Key, Appointments, Classes, Clients, Sales, Staff, Payroll, Sites
- Documentation
- APIReference
- GettingStarted
- OpenAPI
- C# .NET Standard SDK
- PHP SDK
- Python SDK
- Ruby SDK
- Partner OAuth Sample App (C#)
- OAuth 2.0 (Mindbody Identity Service)
- JSON-LD Context
Subscription and delivery platform that pushes near real-time event notifications for sites, locations, appointments, classes, clients, sales, and staff. Partners manage subscriptions over a REST control plane (POST/GET/PATCH/DELETE /api/v1/subscriptions, GET /api/v1/metrics), and Mindbody pushes JSON events with HMAC-SHA256 signature verification via the X-Mindbody-Signature header. Base URL: https://push-api.mindbodyonline.com.
Human URL: https://developers.mindbodyonline.com/WebhooksDocumentation
Base URL: https://push-api.mindbodyonline.com
- Webhooks, Events, Subscriptions, Real-Time, HMAC
- Website
- Documentation
- Developer Portal
- GettingStarted
- SignUp
- Pricing
- Support
- FAQ
- StatusPage
- GitHubOrganization
- Mindbody-API-SDKs
- ReleaseNotes
- Plans
- RateLimits
- FinOps
- SpectralRules
- Vocabulary
| Name | Description |
|---|---|
| Booking and Scheduling | Online booking widgets, class schedules, appointments, enrollments, and Pick-a-Spot reservations. |
| Point of Sale | In-studio POS for products, services, contracts, gift cards, custom payment methods, refunds, and returns. |
| Client Management | Client profiles, contracts, services, contact logs, formula notes, custom fields, and red/yellow alerts. |
| Staff and Payroll | Staff schedules, permissions, availability, class pay, commissions, and time-clock reporting. |
| Webhooks | HMAC-signed, near real-time delivery of site, location, appointment, class, client, sale, and staff events. |
| Identity and OAuth | OpenID Connect via signin.mindbodyonline.com with the Mindbody.Api.Public.v6 scope for delegated calls. |
| Cross-Site Lookup | Discover which Mindbody businesses a client is associated with across the network. |
| Marketplace Listing | Mindbody consumer app marketplace exposes participating studios to nearby members. |
| Name | Description |
|---|---|
| Studio Booking Apps | Build branded mobile or web booking experiences for yoga, pilates, barre, and fitness studios. |
| CRM and Marketing Automation | Sync clients and sales events into CRMs (HubSpot, Salesforce) and trigger marketing journeys. |
| Wellness Aggregator Integrations | Power class/appointment discovery and booking in third-party wellness apps and ClassPass-style platforms. |
| Studio Operations Analytics | Pipe payroll, sales, and class fill data into BI tooling for chain operators. |
| Customer Loyalty Programs | Drive loyalty points and rewards from visit/sale events delivered via the Webhooks API. |
| Network Identity | Use Cross-Site to recognize repeat clients across affiliated Mindbody businesses. |
| Name | Description |
|---|---|
| Mindbody Identity Service | OpenID Connect provider at signin.mindbodyonline.com powering OAuth 2.0 flows for the Public API. |
| Mindbody Marketplace | Consumer app surface exposing participating studios for nearby discovery and booking. |
| Partner Store | Mindbody-vetted directory of integrations at partnerstore.mindbodyonline.com. |
| ClassPass | Aggregator marketplace integrating with Mindbody for class supply. |
| Payment Processors | Integrated card processing and custom payment methods routed through the Sale endpoints. |
| Name | Description |
|---|---|
| Boutique Fitness | Yoga, pilates, barre, indoor cycling, HIIT, and martial-arts studios. |
| Beauty and Salon | Hair, nail, and beauty salons using appointment scheduling and POS. |
| Spa and Wellness | Day spas, medspas, and integrative wellness centers. |
| Health Clubs and Gyms | Multi-location gyms and health clubs with classes, personal training, and recurring memberships. |
Machine-readable API specifications organized by format.
- Mindbody Public API v6 — 148 operations across 11 tags (Appointment, Class, Client, Cross Site, Enrollment, Payroll, Pick A Spot, Sale, Site, Staff, User Token)
- Mindbody Webhooks API — 6 operations across 2 tags (Subscriptions, Metrics)
351 standalone JSON Schema files under json-schema/ — one per OpenAPI component schema, draft 2020-12.
351 standalone JSON Structure files under json-structure/ — converted from the JSON Schemas with strict-typed numeric and date types.
351 example payloads under examples/ — one per schema, populated with realistic Mindbody-shaped values.
Naftiko capabilities organized as self-contained per-tag files, each declaring both a REST adapter and an MCP adapter.
| Capability | API | Tools | Persona |
|---|---|---|---|
| Appointment | Public API v6 | 17 | Studio Front Desk, Booking Bot |
| Class | Public API v6 | 16 | Studio Front Desk, Class Manager, Member |
| Client | Public API v6 | 42 | CRM Operator, Front Desk, Marketing Automation |
| Cross Site | Public API v6 | 1 | Network Admin |
| Enrollment | Public API v6 | 4 | Course Coordinator |
| Payroll | Public API v6 | 4 | Studio Owner, Finance |
| Pick A Spot | Public API v6 | 6 | Studio Front Desk, Member |
| Sale | Public API v6 | 25 | POS Cashier, Membership Sales, Finance |
| Site | Public API v6 | 20 | Site Admin, Integration Engineer |
| Staff | Public API v6 | 10 | Studio Owner, HR |
| User Token | Public API v6 | 3 | Integration Engineer |
| Subscriptions | Webhooks API | 5 | Integration Engineer, Platform Operator |
| Metrics | Webhooks API | 1 | Platform Operator |
- Mindbody Plans and Pricing — Starter ($99/month per location), Accelerate, Ultimate, and Developer Sandbox tiers; Public API access bundled with a 1,000-call-per-key-per-day free quota and ~$0.003 per-call overage in live mode.
- Mindbody Rate Limits — 1,000 calls per API key per day across both live and sandbox modes; live overage billed rather than throttled; sandbox hard-capped; webhook subscriber response SLA of 10s with 15-minute retries up to 3 hours.
- Mindbody FinOps — FOCUS 1.3 aligned, Tiered Subscription + Pay-As-You-Go billing model, monthly invoicing in USD; meters for software_subscription, api_calls_live, api_calls_sandbox, payment_transactions, payment_volume, sms_messages, webhook_deliveries, marketplace_discovery_fees, and add_on_subscriptions.
- Mindbody Vocabulary — Unified taxonomy mapping 13 operational resources, 8 actions, 13 workflows, and 7 personas across the operational (OpenAPI) and capability (Naftiko) dimensions.
- Mindbody Spectral Ruleset — 44 rules across 13 categories enforcing Mindbody API conventions (info/metadata, OpenAPI version, servers, paths, operations, tags, parameters, request bodies, responses, schemas, security, HTTP method conventions, Microcks).
FN: Kin Lane
Email: kin@apievangelist.com