Skip to main content
POST
Cancel a booking

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Path Parameters

id
integer
required

1club booking id (returned by create)

Body

application/json
reason
string

Why the booking is cancelled, recorded on the cancellation and shown to staff wherever the booking's cancellation is (and returned by include=cancellation). Defaults to a note naming the API as the channel.

Maximum string length: 500
notifyCustomer
boolean

Tell the customer their booking was cancelled - email plus the in-app and WhatsApp notification. Defaults to off for a booking this API created, since callers normally send their own notice, and to on for a booking taken through 1club, whose customer expects to hear it from the club. The club's own staff alerts are sent either way.

keepCancellationCharge
boolean

On a booking taken through 1club: true applies the club's cancellation policy, so a late cancellation keeps its charge; false refunds what was paid in full and forgives the rest. Left out, an unpaid booking owes nothing, and a paid one the policy would keep money from is refused with 409 CANCELLATION_CHARGE_DECISION_REQUIRED. Ignored on a booking this API created.

refund
object

What you returned to the customer, on a booking you collected the money for. Omit it to record a full refund of what was collected (API key) or nothing (staff credential).

Response

Booking cancelled

bookingId
integer
status
string
Example:

"cancelled"

refundedAmount
number

What this call recorded as returned to the customer; 0 when nothing was.