Hold seats and create a confirmed escape-room booking via the Bookeo API
domain: www.bookeo.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
POST /holds with eventId, customer (firstName, lastName, emailAddress), participants.numbers (peopleCategoryId + number pairs) and productId to reserve seats temporarily and get a priced quote
Read the returned hold id, price.totalGross and expiration timestamp before the hold lapses
POST /bookings with the same eventId, customer and participants payload, passing previousHoldId as a query parameter to convert the hold into a confirmed booking
Optionally include initialPayments (reason, amount, paymentMethod) in the booking body to record a deposit at creation time
Set notifyUsers and notifyCustomer query parameters to control whether Bookeo sends its own confirmation notifications
Read bookingNumber from the response as the durable identifier for later lookups, updates, or cancellations
Known gotchas
Holds expire — the expiration field in the hold response tells you the deadline after which the seats are released back to inventory
Booking creation without a valid previousHoldId still succeeds but does not benefit from the hold's seat protection
peopleCategoryId values (e.g. Cadults, Cchildren) are account-specific; fetch them from GET /settings/peoplecategories or GET /settings/products rather than hardcoding
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?