Skip to main content
Hold a slot

Authorizations

Authorization
string
header
required

API key — mpk_test_… for the sandbox, mpk_live_… for production. Issued by Maple during partner onboarding.

Body

application/json
slot_token
string
required

A slot_token from a booking availability search, unchanged.

Response

Success

object
enum<string>
required
Available options:
booking_hold
id
string
required

Opaque. bkh_… for a hold in Maple’s ledger; at a provider-managed location, the provider’s own hold token. Round-trip it unchanged.

livemode
boolean
required
created
required
location_id
string
required
starts_at
string
required

ISO-8601 UTC instant of the held slot.

party_size
required
expires_at
string
required

ISO-8601 UTC instant after which the hold no longer claims capacity.