Skip to main content
Use the Services API to define what a shop offers, then assign those services to barbers. Shop services hold the shared catalog; barber assignments control who can sell each service and at what price.

​
What you do first

  1. Create the shop service with name, description, duration, base price, and categories. A service can be a base offering, an add-on, or a bundle of a base plus add-ons at a fixed price.
  2. Set shop-level visibility to visible when the catalog entry is ready (new services are hidden by default).
  3. Assign the service to one or more barbers (batch of 1-25). Set barber visibility and optional price overrides on assign.
  4. Set each barber’s visibility to visible when that barber is ready to offer it.
Assignment can partially succeed: completed assignments stick, and failed ones return problem detail per item.

​
States that matter

Only visible shop services appear in shop listings. Only visible barber services appear in that barber’s booking menu. Barbers cannot change name, description, duration, categories, or bundled add-ons, update the shop service for those. Service kinds
  • Base: bookable alone (for example a haircut).
  • Add-on: enhances an appointment; default price and duration apply when selected alone, and are ignored when the add-on is inside a bundle.
  • Bundle: fixed total for a base plus included add-ons. Included add-ons cannot be removed; customers can still add other add-ons for extra cost. Bundles cannot nest and cannot act as add-ons.
Bundle duration should reflect the sum of included services. On customer-created appointments, prices and durations use system values (with barber overrides). On barber-created appointments, the barber can override the overall appointment price and duration.

​
When a call fails

Failures come back as problem documents. Open the type link for the cause, the fix, and whether retrying is safe. If a barber lacks permission to set custom prices, the API returns 422 with a problem body, visibility changes still work for every barber.