The Bookings Services V2 API allows you to create, manage, and retrieve the
services a business offers to customers. Businesses can offer appointment-based
services, classes, and courses. Each service defines its price, when and where events
take place, how long they last, which staff can provide
them, and which booking policies exist. For example, a booking policy may define the latest time customers
can book, and whether they can reschedule or cancel.
With the Services V2 API, you can:
- Create services.
- Manage services.
- Retrieve and count services.
- Organize service add-ons into groups with customer selection constraints.
A service is an online or in-person offering that a business provides to its
customers.
Wix Bookings supports 3 different types of services:
- Appointments: An appointment is a 1-time event that a customer can book
at a time of their choice during the business hours.
For example, a 30-minute haircut, or 30-minute 1-on-1 personal training.
- Classes: A class is a single event or a series of recurring events. Multiple customers can book a class. Classes may continue indefinitely, without a
pre-defined end date. Events may take place on different days of the week, at
different times, and with different resources, such as staff members.
Customers can book a single event, or multiple events.
For example, a beginners Cross Fit class every Monday at 8 PM and every
Wednesday at 7 PM. Customers can join session of their choice without
committing to attend all sessions.
- Courses: A course starts and ends on pre-defined dates with a limited
number of events. Multiple customers can book a course. In contrast to classes,
customers must book the entire course and can't book individual events.
For example, a once-a-week 12-event introductory course to Pilates, starting
on February 1st and ending on March 17th.
Learn more about service types.
Services can offer additional options called add-ons that customers can purchase alongside the main service. Add-ons are organized into groups, allowing businesses to present related options together and set constraints on customer selections.
For example, a spa service might offer an add-on group called "Relaxing treatments" with options like aromatherapy, hot stone therapy, and reflexology. Customers can choose up to 2 treatments from this group.
Add-ons can be:
- Duration-based: Extend the service time. For example, a 15-minute scalp massage.
- Quantity-based: Allow customers to purchase multiple units. For example, 3 protein bars.
Learn more about add-on groups.
It’s important to note the following points before starting to code:
- Wix Bookings
must be installed on a site before you can use the Services V2 APIs.
- Categories:
Manage how services are grouped in the live site when displayed to customers.
- Service Options and Variants:
Manage custom options and variants for services. For example, pricing based on
session duration or location.
- Staff Members:
Manage staff members and their working schedules.
- Resources: Manage business resources needed to provide services to customers.
- Booking Policies:
Manage policies determining if and how customers can book, reschedule, and
cancel.
- Locations:
Manage business locations. Note that businesses can also provide
services at a location of the customer's choice, or at a custom location that
is not a business location. Learn more about service locations.
For a comprehensive glossary of Wix Bookings terms, see Terminology.