Create Accommodation Candidate

Add a candidate property/room combination to an accommodation set.

Method

POST /v1/products/:id/accommodations/sets/:setId/items

Path Parameters

id · uuid · required

Product ID.

setId · uuid · required

Accommodation set ID.

Body Parameters

All fields are optional; unspecified values default to null, 0, or sensible defaults.

Headers

Authorization · string

Bearer token (requires products:write).

content-type · string

application/json

Request Example

cURL

curl -X POST "https://api.voyantcloud.com/v1/products/prod_123/accommodations/sets/acset_01J0D0EY7XG9ZW5P0N5T0KX6QG/items" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "propertyProductId": "prod_property_123",
    "roomTypeId": "room_789",
    "ratePlanId": "rate_101",
    "board": "half-board",
    "priority": 1,
    "pricingSource": "manual",
    "pricingJson": { "net": 120 }
  }'

Response Example

201 Created

{ "item": { "id": "acitem_01J0D0G0T5ZTRM87X7FQ0KCY4N" } }