POST

Create Multi Service Booking


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a multi-service booking and all included single-service bookings simultaneously.

When to call this method

Create sequential appointments where customers book related services together. For adding existing single-service bookings to an existing multi-service booking, call Add Bookings to Multi Service Booking instead.

Requirements and behavior

Package constraints: Multi-service bookings support 2-8 appointment-based single-service bookings only (course and class bookings aren't supported). All single-service bookings must be at the same location with sequential scheduling and no gaps between appointments.

Timing specification: You must provide complete slot details (scheduleId, startDate, endDate) for each single-service booking. Wix Bookings validates sequential timing but doesn't auto-calculate it.

Package pricing: The total price equals the sum of individual services. Wix Bookings automatically syncs the payment status from the corresponding Wix eCommerce order if the customer paid via an eCommerce checkout.

Package notifications: Customers receive 1 unified notification for the entire multi-service booking. Wix Bookings doesn't send notifications for the package's individual single-service bookings.

Verify availability first with List Multi Service Availability Time Slots.

See Create Booking for more details about constraints and effects of creating single-service bookings.

Permissions
Manage Bookings
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/_api/bookings-service/v2/multi_service_bookings

Errors
400Invalid Argument

There is 1 error with this status code.

403Permission Denied

There is 1 error with this status code.

428Failed Precondition

There are 7 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?