Kitomba API
Kitomba is a cloud salon, spa, and clinic management platform powering online booking, point of sale, client management, inventory, marketing, and payments for beauty businesses across Australia, New Zealand, and beyond. An unofficial API lets you programmatically pull appointments, clients, sales, staff, and inventory—and push updates like new bookings, client records, and stock adjustments back into Kitomba.
What is Kitomba?
Kitomba is a cloud-based salon, spa, and clinic management platform that salons, spas, medispas, and barbershops have trusted for over 20 years across Australia, New Zealand, and globally. Businesses use Kitomba to take 24/7 online bookings, manage staff calendars and client databases, run point of sale and payments through Kitomba Pay, track stock and inventory, run marketing campaigns, and surface real-time reporting on sales and staff performance—all in one unified platform.
Core product areas include:
- Online Booking and Appointment Management (24/7 self-service booking, staff calendars, reminders)
- Client Database and Digital Consultation Forms (profiles, history, intake)
- Point of Sale and Kitomba Pay (card and contactless payments, surcharges, cash reconciliation)
- Stock and Inventory Management (product tracking and reorder)
- Reporting and Analytics (daily sales, appointment trends, staff targets and incentives)
- Marketing Tools (SMS and email campaigns, loyalty, rebooking automation)
Common data entities:
- Appointments, Bookings, Calendar Slots, No-shows
- Clients, Consultation Forms, Loyalty, Visit History
- Sales, Transactions, Payments, Surcharges, Cash Reconciliation
- Services, Products, Stock Levels, Inventory Movements
- Staff, Rosters, Performance Targets, Commissions
The Kitomba Integration Challenge
Salons and spas run their entire day on Kitomba, but moving its data into automated, API-driven workflows is non-trivial:
- No public developer API: Kitomba ships curated pre-built integrations (Xero, Vish, REACH.ai, Mailchimp) but exposes no documented open API or developer portal for custom automation
- Partner-gated integrations: Connections flow through Kitomba's named partner program, so anything outside the official list requires direct vendor engagement
- Web- and terminal-based workflows: Booking, POS, and reporting live behind authenticated web and in-salon terminal sessions rather than a headless data interface
- Multi-location spread: Salon groups run separate sites, staff rosters, and stock per location, each with its own identifiers and reporting context
- Payment and reconciliation nuance: Kitomba Pay surcharges, contactless transactions, and cash reconciliation require careful mapping into accounting and BI systems
- Authentication friction: Salon staff log in interactively, so reliable headless access needs managed sessions and credential handling
How Supergood Creates Kitomba APIs
Supergood reverse-engineers Kitomba's authenticated web and terminal flows to deliver a resilient, API-driven layer over your Kitomba account—without waiting on a public API or partner approval.
- Handles salon login and any verification step securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes appointments, clients, sales, staff, and inventory into consistent JSON objects across single and multi-location accounts
- Maps Kitomba Pay transactions, surcharges, and reconciliation cleanly into downstream accounting and BI
Use Kitomba with AI agents: Kitomba 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 Kitomba API tailored to your account and workflows.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Kitomba evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Kitomba account with salon credentials and obtain a session token for downstream calls.
Appointments
/appointmentsList appointments and bookings across staff calendars with filters for location, staff, service, and date range.
Appointments
/create_appointmentCreate a new booking for a client against a service, staff member, and time slot.
Clients
/clientsRetrieve client records, visit history, loyalty status, and consultation form data.
Sales
/salesPull point-of-sale transactions, payments, surcharges, and Kitomba Pay activity with date and location filters.
Inventory
/inventoryList products, services, stock levels, and inventory movements across locations.
Use Cases
Sync appointments and client data to your stack
- Pull bookings, no-shows, and staff calendar slots into a central warehouse or BI tool - Stream new and updated client records, loyalty, and consultation forms to your CRM - Push externally captured bookings back into Kitomba as confirmed appointments
Reconcile sales and Kitomba Pay into accounting
- Sync POS transactions, payments, and surcharges into Xero or your general ledger - Map Kitomba Pay contactless and card activity with cash reconciliation - Surface daily takings and refunds to finance dashboards automatically
Automate inventory and reorder workflows
- Pull stock levels and inventory movements across locations - Trigger reorder alerts when products fall below thresholds - Reconcile product usage and retail sales against supplier data
Power staff performance and marketing automation
- Pull staff targets, commissions, and performance metrics for reporting - Feed client segments into SMS and email marketing campaigns - Automate rebooking and loyalty reminders from booking history
Technical Specifications
Authentication
Salon credentials and any verification step handled in a managed session
Connectivity
Authenticated web and terminal flows surfaced as a normalized API layer
Response format
Normalized JSON across appointments, clients, sales, inventory, and staff objects
Rate limits
Adaptive throttling tuned to your account to avoid platform-side limits
Session management
Automatic session refresh, re-authentication handling, and credential rotation
Data freshness
Near real-time pulls for bookings, sales, and stock 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, sales, and client changes
Latency
Sub-second reads on cached entities; multi-second writes when posting bookings and sales
Throughput
Horizontally scaled workers sized to multi-location salon group volume
Reliability
Retry, backoff, and idempotency keys for bookings, payments, and stock adjustments
Adaptation
Continuous monitoring of Kitomba releases and UI changes to keep the API stable
Frequently asked questions
Kitomba ships curated pre-built integrations (Xero, Vish, REACH.ai, Mailchimp) but does not publish an open developer API or portal. Supergood creates an API-driven layer over your authenticated Kitomba account so you can automate without one.
Yes. Supergood normalizes appointments, clients, sales, staff, and stock across single and multi-location accounts, preserving per-location identifiers and reporting context.
Yes. Kitomba Pay payments, surcharges, contactless activity, and cash reconciliation are surfaced through the normalized sales API for clean mapping into accounting and BI.
Yes. In addition to reads, the API supports writes such as creating appointments, updating client records, and adjusting stock through the same managed session.
No. Supergood works with your existing Kitomba account and authenticated sessions, so you do not need to join the partner program to integrate.