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.

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}/decline
Event TriggersThis method triggers the following events:
Booking Declined
Was this helpful?
Yes
No