Fresha API
Fresha is a booking and business-management platform for the beauty and wellness industry, used by 130,000+ salons, spas, barbershops, and medspas across 120+ countries. An unofficial API lets you programmatically pull appointments, clients, sales, inventory, and team records—and push updates like new bookings, checkouts, and client profiles back into Fresha.
What is Fresha?
Fresha is a booking and business-management platform for the beauty and wellness industry, combining a consumer marketplace with operational software for salons, spas, barbershops, and medspas. Businesses use Fresha to run their calendar and online bookings, take payments and process point-of-sale checkouts, manage clients and team members, track inventory, and run marketing campaigns. The platform reports 130,000+ partner businesses, 450,000+ stylists and professionals, and over 1 billion appointments booked across 120+ countries.
Core product areas include:
- Calendar & Scheduling (team and resource calendar, appointments, waitlist, group bookings)
- Online Booking (24/7 self-service bookings, built-in forms, deposits and upfront payments)
- Point of Sale & Payments (card terminal, tap-to-pay, client self-checkout, refunds, tips)
- Client Management (360 client profiles, appointment history, client wallet for gift cards, memberships, and packages)
- Team Management (staff accounts and permissions, commissions, shift scheduling, timesheets)
- Inventory & Retail (product sales at checkout, stock sync, purchase orders, online store)
- Marketing & Reporting (email campaigns, client segmentation, loyalty, and business, sales, and finance reports)
Common data entities:
- Appointments, Bookings, Services, Waitlist Entries, Resources
- Clients, Client Profiles, Consultation Forms, Reviews
- Sales, Checkouts, Payments, Refunds, Tips, Deposits
- Products, Inventory, Purchase Orders, Stock Levels
- Team Members, Commissions, Shifts, Timesheets
- Gift Cards, Memberships, Packages, Loyalty Points
The Fresha Integration Challenge
Salons and spas run their entire front desk on Fresha, but turning its portal- and mobile-first workflows into API-driven automation is non-trivial:
- Partner-gated API access: Fresha's developer/API program is oriented toward approved partners and add-ons, so broad, self-serve programmatic access to your own data is limited
- Mobile- and web-app-first data: Much day-to-day data lives behind the Fresha business app and partner portal rather than a documented, openly available REST surface
- Marketplace plus business duality: Consumer-marketplace bookings and in-business checkouts share entities but flow through different surfaces, complicating a single integration
- Authentication complexity: Email/password logins and session-based auth complicate headless, always-on automation
- Payments and PCI sensitivity: Checkout, deposits, and card-terminal flows touch payment data that demands careful, compliant handling
- Multi-location variability: Chains and franchises spread clients, inventory, and team data across locations with their own permissions and settings
How Supergood Creates Fresha APIs
Supergood reverse-engineers the authenticated flows behind the Fresha business app and partner portal to deliver a resilient API layer for your Fresha account—across bookings, payments, clients, inventory, and team data.
- Handles email/password login and session-based auth securely, including any step-up verification
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Appointments, Clients, Sales, Inventory, and Team so you integrate once and rely on consistent objects
- Aligns with multi-location structures, permissions, and per-business settings to ensure compliant access
Use Fresha with AI agents: Fresha 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 Fresha adapter tailored to your account configuration and permissions.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Fresha evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Fresha business account using email/password and obtain a session token for downstream calls.
Scheduling
/appointmentsList appointments and bookings with filters for date range, location, team member, service, and status.
Scheduling
/create_appointmentCreate a new appointment for a client against a service, team member, and time slot.
Clients
/clientsRetrieve client profiles, appointment history, and client-wallet balances for gift cards, memberships, and packages.
Sales
/salesPull sales, checkouts, payments, refunds, and tips across services, products, and memberships.
Inventory
/inventoryList products, stock levels, and purchase orders across one or more business locations.
Use Cases
Sync appointments and client data into your stack
- Pull appointments, bookings, and waitlist entries into a central warehouse or scheduling system - Stream new and changed bookings to downstream CRM and reminder tools - Reconcile client profiles, history, and wallet balances for a unified customer view
Automate point-of-sale and payment reconciliation
- Sync sales, checkouts, refunds, and tips into accounting and BI systems - Match deposits and upfront payments against appointments and memberships - Surface daily takings and commission splits per team member without portal exports
Keep inventory and retail data in sync
- Pull product, stock-level, and purchase-order data across locations - Trigger reorder workflows when stock falls below thresholds - Reconcile retail sales against inventory movements for accurate stock counts
Power marketing and team analytics
- Export client segments and loyalty data into email and SMS platforms - Push team performance, shifts, and commissions into reporting dashboards - Feed booking and sales trends into forecasting and staffing tools
Technical Specifications
Authentication
Email/password and session-based auth handled in a managed session, including step-up verification
Connectivity
Authenticated flows behind the Fresha business app and partner portal, surfaced as a consistent API
Response format
Normalized JSON across Appointments, Clients, Sales, Inventory, and Team objects
Rate limits
Adaptive throttling tuned to your account to avoid Fresha-side limits
Session management
Automatic session refresh, re-authentication handling, and credential rotation
Data freshness
Near real-time pulls for appointments, sales, and clients 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 inventory changes
Latency
Sub-second reads on cached entities; multi-second writes when posting bookings and checkouts
Throughput
Horizontally scaled workers sized to multi-location appointment and sales volume
Reliability
Retry, backoff, and idempotency keys for bookings, checkouts, and inventory updates
Adaptation
Continuous monitoring of Fresha app and portal changes with automatic adapter updates
Frequently asked questions
Fresha's developer and API program is oriented toward approved partners and add-ons, so broad self-serve programmatic access to your own data is limited. Supergood gives you a normalized API over your Fresha account's authenticated surfaces without waiting on partner approval.
Yes. Supergood maps your multi-location structure so clients, appointments, inventory, and team data are accessible across locations with each one's permissions and settings preserved.
Yes. The same normalized API surfaces appointments and bookings alongside sales, checkouts, payments, refunds, and tips, so scheduling and POS data sit together.
Supergood reads checkout, deposit, and payment records for reconciliation while keeping card data within Fresha's compliant boundaries, with encrypted credential storage and scoped access.
Supergood continuously monitors the Fresha business app and partner portal and updates the adapter automatically, so your integration keeps working as Fresha evolves.