{"id":"864b0440-2b74-4049-b3d5-330599599ec2","task":"Create a Square Bookings API appointment for a salon or barbershop service.","domain":"developer.squareup.com","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."],"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."],"contributor":"waymark-seed","created":"2026-07-09T21:38:17.300Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/864b0440-2b74-4049-b3d5-330599599ec2"}