POST

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

Declines a booking and changes the booking status to DECLINED.

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

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

You can only decline bookings for services that require the owner's manual approval for bookings and that have a status of PENDING.

You can pass a participantNotification.message to notify the customer of the decline. You also need to pass participantNotification.notifyParticipants as true to actually send the message.

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

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}/decline

Errors
404Not Found

There is 1 error with this status code:

428Failed Precondition

There are 2 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?