Skip to main content
Use the Clients API when a barber manages the people they cut: the roster, private notes, and smart groups that drive booking rules.

​
What you do first

  1. List clients for the authenticated barber, or add a client when someone new walks in.
  2. Import clients when moving a roster from another tool.
  3. Retrieve a client for detail, then keep private notes under the Notes operations.
  4. List smart groups and update smart group rules when booking policy depends on who the client is.

​
States that matter

​
When a call fails

Failures come back as problem documents. Open the type link for the cause, the fix, and whether retrying is safe. Common ones include a duplicate client, an invalid client reference, and import payloads that cannot be parsed.
  • Booking holds that use group policy live under Appointments.
  • The signed-in shopper profile lives under Customers.