Square Appointments API
Square's Bookings API is public REST with self-serve app registration and sandbox in the Developer Dashboard, OAuth2 scopes, and webhooks. Seller-level write access requires the merchant on Appointments Plus or Premium, and the API is only available in six countries.
Frequently asked questions
Square Appointments scores A on Supergood's API Report Card. Square's Bookings API is public REST with self-serve app registration and sandbox in the Developer Dashboard, OAuth2 scopes, and webhooks. Seller-level write access requires the merchant on Appointments Plus or Premium, and the API is only available in six countries.
Square Appointments has a workable official integration path. Most engineering teams can build against it directly. Open API: self-serve, documented, with SDKs
Square Appointments is the online booking and scheduling product inside Square's (Block, Inc.) broader commerce platform.
Horizontal SMB appointment scheduling, but with overwhelming concentration in personal-services verticals where appointments are tied directly to in-person payment: beauty (hair, nails, lash, tattoo, piercing, barbering), wellness (massage, spa, acupuncture, esthetics, med-spa), fitness (personal training, pilates studios, yoga), pet services (grooming, training, daycare), and light medical (chiropractic, optometry, therapy, alternative medicine). A salon owner or solo professional signs up via the Square Dashboard, configures service menu (cut, color, deluxe pedicure) with prices and durations, sets staff calendars and availability, and publishes a public booking page at `book.squareup.com/...`.
High within SMB beauty/wellness scheduling. Square Appointments rides on Square's broader distribution, Square serves millions of sellers globally and reported $59B+ in gross payment volume in a recent quarter.
Square Appointments is the booking calendar, client CRM, and payments ledger for the service businesses that run on it.
Mature and actively maintained. Square Appointments launched in 2014 (after Square acquired BookFresh) and is operated by Block, Inc. ($NYSE:SQ → now $XYZ), one of the largest publicly traded fintech companies.
Seller-level write operations (full calendar visibility, double-booking, manage other staff's bookings) require the customer to be on Appointments Plus or Premium, buyer-level scope is heavily limited and breaks partner integrations for free-tier sellers. Bookings API is regional, only available in US, UK, CA, AU, ES, JP, leaving partners building cross-border solutions to fall back to alternatives for unsupported geographies. Full sourced list under Sources below.
Common alternatives include Acuity Scheduling, Booksy, Vagaro, Mindbody, Calendly, Fresha. Graded alternatives appear under "More from the report card" below.
Supergood's grades measure one thing: can a customer's engineering team get their own data out programmatically? Supergood checks six things (whether a real API exists, how access is gated, data coverage, auth quality, docs and developer experience, and stability) and rolls them into a letter grade. Supergood re-verifies grades, and they only move on evidence.
Square Appointments scores GOOD on MCP availability. Square's official MCP server covers the full Square API including the Bookings service that powers Square Appointments, with docs at developer.squareup.com and a maintained repo under Square's GitHub org. It runs remotely via OAuth or locally via npx.
Yes. Square Appointments publishes an official MCP server, so MCP clients like Claude, Cursor, and Codex can connect to it directly. Setup instructions are in the vendor's documentation.