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.

Permission Scopes

For app development, you must have one of the following permission scopes:
Manage Bookings
Manage Bookings - all permissions
Learn more about permission scopes.
Endpoint
POST
https://www.wixapis.com/bookings/v2/bookings/{bookingId}/confirm

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No