Search.../
  1. Home
  2. Getting Started
  3. Overview
Generate a test token to explore our APIs

Decline Booking

Developer Preview

Decline a booking request.
When invoking this API the following takes place:

  • The participant status on the session changes to DECLINED.
  • The corresponding session or participant is deleted from the calendar.

  • The Booking status changes to DECLINED.

    Permissions
    This endpoint requires the Manage Bookings permission scope.

Authorization

This endpoint requires an authorization header - pass the access token from the OAuth installation flow.

POST

https://www.wixapis.com/bookings/v1/bookings/{id}/decline

Path Params

NAME
TYPE
DESCRIPTION
id
Required

string

the Booking id to decline

Body Params

NAME
TYPE
DESCRIPTION
participantNotification

object

Whether to notify participants about the change and an optional custom message

Response Object

NAME
TYPE
DESCRIPTION
id

string

Status/Error Codes

The response will include an HTTP status code.

Was this helpful?

Decline Booking

Decline a booking in pending state. For example, a business owner declines a pending bookings request done by a site visitor.

Request

curl

Copy Code
1curl -X POST \
2 'http://www.wixapis.com/bookings/v1/bookings/e0e5f390-6302-46fc-a5ee-a2ec5000d4e8/decline' \
3 -H 'Authorization: <AUTH>'
4 --data '{
5 "id" : "e0e5f390-6302-46fc-a5ee-a2ec5000d4e8"
6 "participantNotification" : {
7 "notifyParticipants": true,
8 "message" = "Thanks for your request, but I am busy."
9 }
10 }'

Response

json

1
2{"id": "e0e5f390-6302-46fc-a5ee-a2ec5000d4e8"}