Overview

Booking APIs expose the same availability and appointment actions used by the seller dashboard. Use the listing Sanctum ability for booking configuration and date overrides. Use the invoice ability for customer appointment reads, cancellation, and rescheduling.

All resources are scoped to the store selected by X-STORE. Product, variant, booking, and provider-connection IDs from another store return an authorization or not-found response rather than crossing store boundaries.

Endpoints

• List appointments
• Search appointments
• Retrieve an appointment
• Update an appointment
• Retrieve booking configuration
• Update booking configuration
• List booking date overrides
• Set booking date availability

Time and concurrency

Appointment instants are returned as ISO 8601 timestamps. Configuration uses an IANA timezone for weekly availability and local date overrides. A local date can span 23 or 25 hours when daylight saving time changes; SellApp stores the corresponding UTC boundaries.

Administrative rescheduling uses the same product- or variant-level conflict lock as checkout holds. Availability is checked again inside that boundary, and a stale request cannot overwrite a cancelled appointment or reserve a slot already held by another appointment.

Webhooks

Appointment changes can be observed by enabling the public events booking.cancelled and booking.rescheduled on a webhook channel. Payloads contain safe appointment state and omit provider error details and credentials.