Apply promotion codes and gift vouchers when creating a Bookeo booking

domain: www.bookeo.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Collect the customer's promo/coupon code text exactly as they enter it, without trying to parse or validate it client-side
  2. Pass it in the promotionCodeInput field on the POST /holds or POST /bookings request body (comma-separate multiple coupon codes if the promotion type allows it)
  3. Pass any gift voucher code in the giftVoucherCodeInput field; only one specific (service-tied) voucher can be applied per booking, but multiple generic value-based codes can be comma-separated
  4. Read back promotionApplicable and appliedPromotionDiscount from the hold response to confirm a discount was actually applied before showing a price to the customer
  5. Read applicableGiftVoucherCredit on the hold response to see the credit that will be deducted if the booking is saved
  6. After booking creation, read promotionName, couponCodes, and specificVoucherCode on the booking object to display what was redeemed

Known gotchas

Related routes

Hold seats and create a confirmed escape-room booking via the Bookeo API
www.bookeo.com · 6 steps · unrated
Register and verify Bookeo webhooks for booking lifecycle events
www.bookeo.com · 6 steps · unrated
Apply and validate gift cards and promo codes before checkout
agentic-commerce · 6 steps · unrated

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?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans