Skip to main content
POST
Create booking

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

dryRun
enum<string>
default:true
required

When true, validates and simulates the request but performs no writes. Recommended when calling from docs.

Available options:
true

Body

application/json
items
object[]
required

Booking line items (venue and/or services)

date
string
required

Booking date (ISO date)

Example:

"2025-12-04"

time
string
required

Start time

Example:

"09:00"

duration
object

Duration in hours

Example:

4

startTime
string

Start timestamp (ISO)

Example:

"2025-12-04T09:00:00Z"

endTime
string

End timestamp (ISO)

Example:

"2025-12-04T13:00:00Z"

packageId
string

DEPRECATED: Use items[].selectedPackages instead

upgradeBookingId
object

If provided, upgrade existing booking instead of creating new one

specialRequests
string

Optional message to host (e.g. purpose of event)

paymentFlow
enum<string>

Payment flow: hosted_checkout (redirect) or payment_sheet (native)

Available options:
hosted_checkout,
payment_sheet

Response

Success

mode
enum<string>
required

Result mode

Available options:
approval_required,
instant_booking
Example:

"instant_booking"

bookingId
string

Booking ID (when mode is approval_required or instant_booking with payment sheet)

Example:

"550e8400-e29b-41d4-a716-446655440000"

message
string

Message for user when approval is required

Example:

"Your request has been sent to the host."

checkoutUrl
string

Stripe Checkout URL (when mode is instant_booking and payment flow is hosted_checkout)

Example:

"https://checkout.stripe.com/c/pay/cs_..."

paymentIntentClientSecret
string

Stripe PaymentIntent client secret (when mode is instant_booking and payment flow is payment_sheet)

Example:

"pi_xxx_secret_xxx"

publishableKey
string

Stripe publishable key (when mode is instant_booking and payment flow is payment_sheet)

Example:

"pk_test_..."