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 the 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.
Grades measure one thing: can a customer's engineering team get their own data out programmatically? We check six things (whether a real API exists, how access is gated, data coverage, auth quality, docs and developer experience, and stability) and roll them into a letter grade. Grades get re-verified, and they only move on evidence.