Setmore API
Setmore is a free online appointment scheduling platform that automates booking, reminders, payments, and calendar management for service-based businesses like salons, spas, and barber shops. An unofficial API lets you programmatically pull appointments, customers, services, and staff—and push updates like new bookings, reschedules, and cancellations back into Setmore—without waiting on Pro-gated, per-app API approval.
What is Setmore?
Setmore is a free online appointment scheduling platform that automates booking, reminders, payments, and calendar management for service-based businesses. Salons, spas, barber shops, and other appointment-driven businesses use Setmore to run a branded online booking page, manage staff calendars and real-time availability, send automated email and SMS reminders, take payments through Stripe, Square, and PayPal, and host video meetings via Zoom and Google Meet.
Core product areas include:
- Online Booking Page with customizable branding, website widget, and QR-code booking
- Calendar management with real-time availability across staff and locations
- Automated email and SMS appointment reminders
- Payment processing via Stripe, Square, and PayPal
- Class booking, video meetings (Zoom, Google Meet), and a live receptionist service
- Integrations with Facebook, Instagram, Google Calendar, Office 365, WordPress, and Salesforce
Common data entities:
- Appointments, time slots, and class sessions
- Customers and contact records
- Services, durations, and pricing
- Staff/team members and their availability
- Payments, reminders, and booking-page configuration
The Setmore Integration Challenge
SMBs run their entire front desk on Setmore, but programmatic access is gated and uneven:
- Pro-tier paywall: the API is only available on a paid Setmore Pro account, so businesses on the free plan have no programmatic path to their own data
- Per-app manual approval: access requires emailing api@setmore.com with your name, registered email, and intended use case, then waiting for the team to review and approve each request
- OAuth 2.0 token handling: every request uses OAuth 2.0 with bearer tokens that must be issued, stored, and refreshed, complicating headless automation
- No sandbox environment: all API calls hit live accounts, so testing means standing up and isolating a separate production account
- Undocumented rate limits: limits are enforced but specifics live behind the docs, making it hard to size syncs without trial and error
- Mobile-and-web-first design: much of the booking, reminder, and payment workflow is built for the apps and booking page rather than bulk machine-to-machine export
How Supergood Creates Setmore APIs
Supergood reverse-engineers authenticated browser and app flows alongside Setmore's OAuth-based booking API to deliver a resilient, normalized API layer for your Setmore account—without the wait on Pro-gated, per-app approval.
- Handles username/password and OAuth 2.0 token issuance and refresh securely in a managed session
- Maintains session continuity with automated refresh and change detection so syncs keep running
- Normalizes responses across appointments, customers, services, and staff so you integrate once and rely on consistent objects
- Adapts throttling to undocumented rate limits and works against live accounts safely, with no separate sandbox required
Use Setmore with AI agents: Setmore MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your booking workflows, account tier, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Setmore adapter tailored to your account, services, and staff configuration.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Setmore evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Setmore account using credentials or OAuth 2.0 and obtain a bearer token for downstream calls.
Appointments
/appointmentsList appointments with filters for staff, service, customer, status, and date range.
Appointments
/create_appointmentBook a new appointment for a customer against a service, staff member, and time slot.
Appointments
/appointmentsReschedule or cancel an existing appointment and update its status.
Customers
/customersRetrieve customer and contact records with their booking history.
Services
/servicesPull the service catalog with durations, pricing, and assigned staff.
Use Cases
Sync appointments into your data warehouse
- Pull appointments, services, and staff assignments into a central warehouse - Stream booking, reschedule, and cancellation events to downstream BI and ops tools - Reconcile customer records across Setmore and your CRM for a unified view
Automate booking from your own front end
- Create appointments programmatically from a custom or white-label booking flow - Check real-time staff availability before confirming a slot - Push reschedules and cancellations back into Setmore without portal clicks
Keep customer and service data in sync
- Sync new and updated customer records into marketing and loyalty systems - Mirror the service catalog, durations, and pricing into external storefronts - Trigger follow-up workflows when an appointment is completed or no-shows
Power AI agents and assistants
- Expose appointments, customers, and availability to AI scheduling agents - Let assistants book, reschedule, and cancel on behalf of staff or clients - Surface upcoming-appointment and reminder context to agent workflows
Technical Specifications
Authentication
OAuth 2.0 bearer tokens (plus credentialed login) handled in a managed session
Connectivity
Setmore's OAuth booking API plus authenticated browser and app flows where the API is gated
Response format
Normalized JSON across Appointments, Customers, Services, and Staff objects
Rate limits
Adaptive throttling tuned to Setmore's undocumented per-account limits to avoid lockouts
Session management
Automatic OAuth token refresh, credential rotation, and re-auth handling
Data freshness
Near real-time pulls for appointments and customers with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for appointment created, rescheduled, cancelled, and completed
Latency
Sub-second reads on cached entities; multi-second writes when booking through availability checks
Throughput
Horizontally scaled workers sized to multi-staff, multi-location booking volume
Reliability
Retry, backoff, and idempotency keys for bookings, reschedules, and cancellations
Adaptation
Continuous monitoring of Setmore releases and booking-flow changes to absorb drift
Frequently asked questions
Setmore's own API requires a paid Pro account and per-app approval. Supergood works against your existing authenticated Setmore sessions, so you can access your appointment, customer, and service data without being blocked by the Pro paywall or approval queue.
Yes. Setmore's native API requires emailing api@setmore.com with your name, registered email, and use case, then waiting for review. Supergood removes that wait by generating the integration directly against your account.
Setmore uses OAuth 2.0 with bearer tokens. Supergood issues, stores, and refreshes those tokens in a managed, encrypted session so your automation keeps running without manual token juggling.
Setmore offers no sandbox; all calls hit live accounts. Supergood works safely against live accounts with adaptive throttling and idempotent writes, so you can test and deploy without standing up a separate test account.
You can list, create, reschedule, and cancel appointments, plus read customers, services, and staff. Booking and availability writes are handled with retries and idempotency to keep your calendar consistent.