Booker API
Booker (by Mindbody) is an all-in-one salon and spa management platform that powers appointment scheduling, point-of-sale, payments, memberships, gift cards, inventory, and marketing for beauty and wellness businesses. An unofficial API lets you programmatically pull appointments, clients, staff, services, transactions, and inventory—and push updates like new bookings, checkouts, membership sales, and marketing campaigns back into Booker.
What is Booker?
Booker is an all-in-one salon and spa management platform from Mindbody, built for appointment-based beauty and wellness businesses—salons, spas, hotel spas, massage studios, and barbershops. Businesses use Booker to manage calendars and staff scheduling, take payments through an integrated point-of-sale, sell memberships, gift cards, and packages, track back-bar and retail inventory, and run email and text marketing campaigns. Clients book online or through the Mindbody app, and brands like Drybar, IHG Hotels & Resorts, and Massage Addict run their operations on the platform.
Core product areas include:
- Run & Manage (calendar, staff scheduling, payroll, rooms and equipment, inventory tracking)
- Client Booking (24/7 online scheduling, Messenger[ai], Mindbody app discovery)
- Payments & POS (mobile transactions, Apple Pay, integrated point-of-sale, cash drawer reconciliation)
- Memberships, Gift Cards & Packages (recurring memberships, gift card sales, prepaid packages)
- Marketing (branded booking experience, email and text campaigns, referral and review tools)
- Reporting (revenue trends, key metrics, detailed transaction reporting)
Common data entities:
- Appointments, Schedules, Services, Service Categories
- Clients, Customer Profiles, Booking History, Reviews
- Staff, Employees, Payroll, Tips, Availability
- Transactions, Payments, Invoices, Cash Drawer Reconciliation
- Memberships, Gift Cards, Packages, Series
- Inventory, Retail Products, Back-Bar Stock, Suppliers
- Marketing Campaigns, Email/Text Lists, Referrals
The Booker Integration Challenge
Salons and spas run their daily operations on Booker, but turning its portal- and POS-driven workflows into API-driven automation is non-trivial:
- Limited public API: Booker's developer API access is gated and partner-oriented, so most businesses can't self-serve programmatic access to their own data
- Mindbody platform spread: Data sits across Booker, Messenger[ai], and the broader Mindbody ecosystem, each with its own object models and IDs
- Partner-gated integrations: Many capabilities flow through approved partners (e.g. BookingBee.ai), requiring partnership agreements before API access
- Authentication complexity: Location-scoped logins and multi-location accounts complicate headless automation
- Real-time scheduling constraints: Appointment availability, processing-time gaps, and room/equipment conflicts must be honored on every write
- POS and payment coupling: Checkouts, tips, gift cards, and memberships are tightly bound to the integrated POS, making clean transactional reads and writes tricky
How Supergood Creates Booker APIs
Supergood reverse-engineers Booker's authenticated browser and POS flows to deliver a resilient API layer for your location—across scheduling, payments, memberships, and inventory—without waiting on partner-gated API approval.
- Handles username/password and MFA securely across single- and multi-location accounts
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Appointments, Clients, Staff, Transactions, and Inventory so you integrate once and rely on consistent objects
- Respects scheduling rules, processing times, and POS state so writes stay consistent with the Booker UI
Use Booker with AI agents: Booker MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your locations, modules, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Booker adapter tailored to your account configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Booker evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Booker location using username/password or MFA and obtain a session token for downstream calls.
Scheduling
/appointmentsList appointments across staff, services, and locations with filters for date range, status, and customer.
Scheduling
/create_appointmentBook a new appointment for a client honoring service duration, processing time, staff availability, and room/equipment constraints.
Clients
/clientsRetrieve client profiles with contact details, booking history, memberships, and review activity.
Payments
/transactionsPull point-of-sale transactions, payments, tips, gift card sales, and cash drawer reconciliation records.
Payments
/checkoutProcess a checkout for services and retail, apply memberships, packages, or gift cards, and capture payment.
Use Cases
Sync appointments and client data into your stack
- Pull appointments, services, and staff schedules from Booker into a central warehouse or BI tool - Stream new bookings, reschedules, and cancellations to downstream CRM and analytics - Reconcile client profiles, booking history, and reviews for a unified customer 360
Automate online and phone booking workflows
- Create appointments programmatically from external channels honoring availability and processing time - Trigger AI-driven follow-ups for cancellations and no-shows - Push confirmation and reminder events to email and text systems without portal clicks
Reconcile POS, payments, and memberships
- Sync transactions, tips, and gift card sales from the integrated POS into accounting and AR systems - Match membership and package redemptions against client accounts - Surface daily cash drawer reconciliation and revenue trends to finance workflows
Keep inventory and marketing data in sync
- Pull retail and back-bar inventory levels for replenishment and supplier ordering - Push marketing campaign audiences and segments based on booking and spend behavior - Trigger referral and review requests when an appointment is completed
Technical Specifications
Authentication
Username/password and MFA handled in a managed session across single- and multi-location accounts
Connectivity
Authenticated browser and POS flows surfaced as a clean REST-style API, no partner approval required
Response format
Normalized JSON across Appointments, Clients, Staff, Transactions, Memberships, and Inventory objects
Rate limits
Adaptive throttling tuned to your location to avoid Booker-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for appointments, clients, and transactions with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for new bookings, reschedules, cancellations, checkouts, and membership changes
Latency
Sub-second reads on cached entities; multi-second writes when posting bookings and checkouts through the POS
Throughput
Horizontally scaled workers sized to multi-location appointment and transaction volume
Reliability
Retry, backoff, and idempotency keys for bookings, checkouts, and membership transactions
Adaptation
Continuous monitoring of Booker and Mindbody platform releases and UI changes to keep the adapter stable
Frequently asked questions
No. Supergood works with your existing Booker login and authenticated sessions, so you don't need to wait on partner-gated developer API approval to access your own appointment, client, and transaction data.
Yes. Supergood handles location-scoped logins and normalizes data across locations, so multi-site salon and spa brands can pull appointments, clients, and transactions through one consistent API surface.
Yes. Bookings respect service duration, processing-time gaps, staff availability, and room or equipment constraints, so appointments created through the API stay consistent with what the Booker UI would allow.
Yes. Transactions, tips, gift card sales, memberships, and packages from the integrated point-of-sale are exposed through the normalized API, alongside scheduling and client data.
Booker is part of the Mindbody ecosystem. Supergood profiles your specific Booker account and normalizes its objects rather than forcing a generic Mindbody schema, preserving your configuration and entitlements.