Skip to content

What's new in v2

Bookings

  • Create, fetch, update, and delete any booking by id (/bookings/{id}).
  • Book group classes: use type: SESSION with a CLASS service. A session holds up to 50 customers, and never more than the class's max_seats.
  • Add or remove a customer on a class session (POST and DELETE /bookings/class/{session-id}/attendees/{customer-id}).
  • Create and update events, which are calendar entries that aren't tied to a service (/bookings/events).
  • Attach a video meeting to a booking with location.
  • List bookings by staff member or by customer, with date filters (start_at, end_at) and paging.

Slots

  • Fetch upcoming class sessions and their seat availability (GET /slots/class/{class-key}). A class with no upcoming sessions returns an empty days map.
  • Slots now return end_at as well as start_at.

Services and categories

  • Create, update, and delete services and categories (v1 was read-only).
  • Assign or unassign staff members for a service (PUT /services/provider/{id}).
  • Filter services by provider_id, and include deleted services with is_deleted.
  • Categories reference their services (service_ids), and services reference their categories (category_ids).
  • Every service is also in the default category for its type: All Services for a SERVICE and All Class Bookings for a CLASS. It is added when category_ids is empty or leaves it out. Each id in category_ids must be an existing category of your account, and an id must not be repeated.
  • A SERVICE needs at least one id in provider_ids; ids that are empty or the text null are rejected.
  • The type of a service cannot be changed after it is created.
  • currency cannot be sent when you create or update a service; the service uses your account's currency.

Working hours

  • Fetch the working hours of every staff member, or of one staff member (/working-hours/staffs).

Contacts

  • Update and delete customer contacts, and create many at once with POST /customers/bulk.
  • Read staff contacts (/staff).