POST

Confirm 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.

Confirms a booking and changes the booking status to CONFIRMED.

You can only confirm bookings that have a status of PENDING, CREATED, or WAITING_LIST.

Calling this endpoint doesn't check whether a slot or schedule is still available at this time.

For appointment services the slot may become unavailable, depending on the service's policy.bookingApprovalPolicy.requestsAffectsAvailability.

Calling this endpoint also changes the session's participants.approvalStatus to APPROVED.

You can pass a participantNotification.message to notify the customer of the confirmation. You also need to pass participantNotification.notifyParticipants as true to actually send the message. If you don't define participantNotification.message, the participant notification for the booking defaults to the one specified when the booking was created.

You can pass sendSmsReminder as true if you want an SMS reminder to be sent to the phone number specified in the ContactDetails 24 hours before the session starts. If you don't define the reminder, the SMS reminder for the booking defaults to the one specified when the booking was created.

If you provide paymentStatus, this status is applied to the booking. Otherwise, the payment status for the booking remains unchanged.

Bookings are automatically confirmed when both of the following conditions are met:

  • The service is configured to automatically confirm
  • The eCommerce (coming soon) order has been approved.

The slot's or schedule's availability is checked just before confirming the booking as part of the automatic flow.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings - all permissions
Manage Bookings
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/bookings/v2/bookings/{bookingId}/confirm

Errors
404Not Found

There is 1 error with this status code:

428Failed Precondition

There are 3 errors with this status code:

See the entire list and learn more about Wix errors.

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