SalonRunner API
SalonRunner is a cloud-based, privately branded salon and spa management platform covering online booking, point of sale, inventory, employee management, client communications, and marketing. An unofficial API lets you programmatically pull appointments, clients, services, sales, and inventory—and push updates like new bookings, checkouts, and client records back into SalonRunner.
What is SalonRunner?
SalonRunner is a cloud-based, privately branded salon and spa management platform built from the ground up as a multi-tenant web application. Salons and spas use it to let clients book their own appointments online, ring up sales at the point of sale, track inventory in real time, manage staff and schedules, and run client communications and marketing—all accessible from any device through a fully responsive web app.
Core product areas include:
- Online Client Scheduling (clients self-book and view service, product, and gift card history via web, social, or mobile web app)
- Point of Sale (ring up sales, manage the cash drawer and transaction types, with integrated credit card processing on any device)
- Inventory Management (real-time tracking that adjusts on sales, returns, and receipts with low-stock trigger alerts)
- Employee Management (staff scheduling and access)
- Client Connect (Enhanced SMS, Text Confirmations, Client Images, Image Library, Mass Emails, and Automated Emails)
- Marketing and eCommerce (targeted campaigns and online product/gift card sales)
- Advanced Reporting (sales, inventory, and client analytics)
Common data entities:
- Appointments, Services, Service Providers, Availability
- Clients, Client Images, Service and Product History, Notes
- Sales, Transactions, Payments, Cash Drawer
- Products, Inventory Levels, Receipts, Returns
- Gift Cards and Balances
- Employees, Schedules, Roles
- Email and SMS Campaigns, Automated Messages
The SalonRunner Integration Challenge
Salons and spas run daily operations on SalonRunner, but turning its web- and mobile-driven workflows into API-driven automation is non-trivial:
- No public API: SalonRunner does not publish developer documentation or expose a public, programmatic interface—data lives behind the authenticated web and mobile app
- Private branding per tenant: The product is privately branded per salon, so portal URLs, theming, and entry points vary across deployments
- Mobile-web access patterns: Much of the booking and checkout experience runs through the responsive mobile web app, complicating headless automation
- Session-bound data: Appointments, client history, and gift card balances are only reachable inside an authenticated session that must be maintained and refreshed
- Real-time inventory coupling: Stock figures adjust on every sale, return, and receipt, so reads and writes must respect live inventory state and trigger points
- Payment and gift card sensitivity: Point-of-sale transactions, integrated card processing, and gift card balances demand careful, idempotent handling
How Supergood Creates SalonRunner APIs
Supergood reverse-engineers SalonRunner's authenticated web and mobile-web flows to deliver a resilient, normalized API layer for your salon or spa account—no public API required.
- Handles username/password sign-in and any MFA challenges securely in a managed session
- Maintains session continuity with automated refresh and change detection across the privately branded portal
- Normalizes responses across Appointments, Clients, Sales, Inventory, and Gift Cards so you integrate once and rely on consistent objects
- Respects real-time inventory state and gift card balances with idempotent, retry-safe writes
Use SalonRunner with AI agents: SalonRunner MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, branded portal, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready SalonRunner adapter tailored to your account and workflows.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as SalonRunner evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a SalonRunner account using username/password and any MFA challenge, returning a session token for downstream calls.
Scheduling
/appointmentsList appointments with filters for date range, service provider, client, and status.
Scheduling
/create_appointmentBook a new appointment for a client against a service, provider, and available time slot.
Clients
/clientsRetrieve client records including profile, service and product history, notes, and gift card balances.
Point of Sale
/create_saleRing up a point-of-sale transaction with services, products, payments, and gift card redemption.
Inventory
/inventoryPull real-time product inventory levels, low-stock alerts, and recent receipts and returns.
Use Cases
Sync appointments and client data into your stack
- Pull appointments, providers, and availability into a central calendar or warehouse - Reconcile client profiles, service history, and notes across marketing and CRM tools - Surface gift card balances and visit history for a unified client view
Automate booking and reminder workflows
- Create and reschedule appointments programmatically without portal clicks - Trigger Enhanced SMS and email confirmations and reminders from external systems - Route no-show and cancellation events to retention and rebooking flows
Reconcile point-of-sale and inventory
- Stream sales, payments, and gift card redemptions into accounting and BI - Match real-time inventory adjustments against receipts, returns, and low-stock triggers - Reconcile integrated credit card transactions with daily cash-drawer totals
Power client marketing and analytics
- Export client segments to drive Mass Emails and Automated Emails campaigns - Feed advanced reporting data into external dashboards - Sync product and service catalogs to eCommerce and loyalty tools
Technical Specifications
Authentication
Username/password and MFA challenges handled in a managed session
Connectivity
Authenticated web and responsive mobile-web flows reverse-engineered from the privately branded portal
Response format
Normalized JSON across Appointments, Clients, Sales, Inventory, and Gift Card objects
Rate limits
Adaptive throttling tuned to your account to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for appointments, sales, and inventory 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, cancellations, checkouts, and low-stock alerts
Latency
Sub-second reads on cached entities; multi-second writes when posting bookings and sales
Throughput
Horizontally scaled workers sized to multi-location appointment and transaction volume
Reliability
Retry, backoff, and idempotency keys for bookings, sales, and gift card transactions
Adaptation
Continuous monitoring of SalonRunner releases and branded-portal changes with automatic adjustment
Frequently asked questions
No. SalonRunner does not publish developer documentation or expose a public API. Supergood works against your authenticated web and mobile-web sessions to provide a programmatic API layer over your account's data.
Yes. Supergood normalizes the booking flow so you can list availability, create and reschedule appointments, and trigger confirmations and reminders without manual portal clicks.
Yes. The adapter is configured to your salon's branded SalonRunner portal, handling its specific URLs, theming, and entry points while returning consistent normalized objects.
Sales, payments, and gift card redemptions are exposed alongside real-time inventory levels. Writes are idempotent and retry-safe so checkouts and stock adjustments stay consistent with live state.
Supergood continuously monitors SalonRunner releases and branded-portal changes, automatically adjusting the adapter so your integration keeps running without manual maintenance.