Create a Square Bookings API appointment for a salon or barbershop service.
domain: developer.squareup.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate with OAuth and request the APPOINTMENTS_WRITE scope (or APPOINTMENTS_ALL_WRITE plus APPOINTMENTS_WRITE for seller-level access).
Confirm the seller is subscribed to Appointments Plus or Appointments Premium if you need seller-level booking permissions.
Look up the target location_id, team_member_id, and service_variation_id (with its service_variation_version) via the Locations, Team, and Catalog APIs.
Call POST /v2/bookings with Booking.location_id, Booking.start_at, and an AppointmentSegment containing the team_member_id, service_variation_id, and service_variation_version.
Use the corresponding retrieve/update/cancel bookings endpoints to manage the appointment afterward.
Known gotchas
Seller-level booking (as opposed to buyer-level) requires the seller's account to actively subscribe to Appointments Plus or Premium — booking calls fail for sellers on lower tiers even with correct OAuth scopes.
service_variation_version must match the catalog item's current version; using a stale version value from a cached catalog response can cause the booking call to be rejected.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?