Skip to main content

​
Method

POST /v1/bookings/wizard

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (requires bookings:write).
​
content-type
string
application/json

​
Request Example

curl -X POST "https://api.voyantcloud.com/v1/bookings/wizard" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "productId": "prod_123",
    "departureId": "dep_456",
    "currency": "EUR",
    "language": "en",
    "paxAdults": 2,
    "rooms": [
      { "categoryKey": "double", "occupancy": 2, "quantity": 1 }
    ],
    "billing": {
      "firstName": "Alex",
      "lastName": "Rivera",
      "email": "alex@example.com"
    }
  }'

​
Response Fields

​
accepted
boolean
required
true when the payload is queued for downstream processing.
​
code
string
required
Opaque tracking code generated for the wizard submission.

​
Response Example

{ "accepted": true, "code": "2F4D9A1C" }
This endpoint does not persist bookings immediately. Trigger.dev workflows ingest the payload (using the returned code or session context) to create the booking after payment confirmation.