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 (SDK | REST) 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 (SDK | REST) if the customer paid via an eCommerce checkout (SDK | REST).

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 (SDK | REST).

See Create Booking (SDK | REST) for more details about constraints and effects of creating single-service bookings.

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?