The Wix Bookings APIs allow you to build and customize booking experiences for any service-based business.
You can manage services, staff members, resources, pricing, availability, and customer bookings throughout their entire lifecycle.
Wix Bookings APIs include:
- Services: Create, manage, and query the specific offerings a business provides.
- Staff Members: Manage people who provide services, including their working hours.
- Resources: Manage physical assets like rooms and equipment that the business needs to provide a service.
- Pricing: Calculate booking costs and implement custom pricing logic through service plugins.
- Policies: Define rules for when and how customers can book, cancel, or reschedule services.
- Time Slots: Check availability of appointment slots and class events for efficient booking and scheduling.
- Bookings: Manage customer bookings for individual services or multiple services at once.
- External Calendar: Connect and sync with external calendar providers like Google, Microsoft, and Apple calendars.
These concepts form the foundation of the Wix Bookings platform.
Wix Bookings supports 3 service types:
- Appointments: On-demand bookings for available time slots. For example, haircuts or consultations.
- Classes: Scheduled sessions that customers can join individually. For example, drop-in yoga classes or weekly cooking lessons.
When a specific event is fully booked, customers can join a waitlist and are notified if a spot opens up.
- Courses: Multi-session programs that customers must book in full. For example, 8-week programming bootcamps or certification training programs.
Learn more about service types.
Wix Bookings integrates with the Calendar APIs to manage when services can be booked.
Wix Bookings uses 2 key components to manage when services can be booked:
- Events are time-specific instances of services (like an appointment or class session).
- Schedules organize these events and define when services are available or when resources are booked.
Each service, staff member, and resource has associated schedules and events in the calendar system.
Wix Bookings automatically creates and manages schedules and events when you create services, staff members, or bookings.
For details about how staff and resources affect scheduling, see the Staff members and resources section below.
Time slots represent specific periods when services can be booked.
The Wix Bookings and Calendar APIs work together to manage availability:
- Wix Bookings APIs handle availability queries and booking validation.
Use the Time Slots API to find available time slots for appointments and classes.
The availability calculation considers multiple factors: service schedules, staff working hours, resource availability, booking policies, and existing reservations.
For courses, you need to manually calculate availability based on total capacity since customers must book the entire program, as described in the end-to-end booking flow.
- Wix Calendar APIs manage the underlying schedule data and events. Wix Bookings automatically creates and updates calendar events when bookings are made.
For most use cases, you'll use Calendar APIs to retrieve schedule and event data for display purposes, while Wix Bookings handles creation and management automatically.
For detailed information about the integration, see How Wix Bookings Uses the Calendar APIs.
Staff members are people who provide services and have complex scheduling needs.
They have both working hours (when they're available to work) and event schedules (when they're actually booked).
Resources are physical assets like rooms, equipment, or facilities needed for services. They only have event schedules showing when they're booked, with availability based on business hours.
Learn more about resources and staff members.
Services can be free or have fixed pricing or varied pricing based on different factors like staff member, time of day, or customer type.
Wix Bookings supports custom pricing integrations through the Pricing Integration service plugin, allowing you to implement dynamic pricing logic.
You can also create service packages and memberships using Wix Pricing Plans, which allow customers to purchase bundles of services or recurring access to bookings.
For detailed information, see About Service Payments.
Wix Bookings integrates with the Wix eCommerce platform to handle payments and order management.
All bookings use eCommerce orders to maintain proper records and functionality.
By default, Wix Bookings handles the entire checkout and order creation process automatically.
To customize the checkout process, you can choose between 2 approaches:
- Wix eCommerce checkout: Use the Wix eCommerce Checkout APIs. Wix Bookings automatically processes payments, creates eCommerce carts, checkouts, and orders, and updates booking statuses.
- Custom checkout: Build your own payment interface and process payments with external providers.
You must still manually create an order in the Wix eCommerce platform and update the booking status to complete the booking flow.
For step-by-step implementation examples, see our end-to-end booking flows.