CLcloudbeds
Items

Post one or more items to a reservation, house account, or group profile

Adds items to a reservation, house account, or group profile. This endpoint supports batch operations, allowing multiple items to be posted in a single request. Each item can have associated payments and custom pricing.

post/item/v1/items

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/item/v1/items
  • Auth
    OAuth 2
    Authorization code: https://api.cloudbeds.com/auth/oauth/authorize
    Token URL: https://api.cloudbeds.com/auth/oauth/token scopes: write:item

Headers

x-property-idstring required
Example:1,2,3

A numeric, comma-separated string representing the property IDs, sent in the header.

Request body

OR
OR

Example request

{
  "reservationId": "RES123456",
  "houseAccountId": "123456",
  "eventCode": "GRP2025",
  "saleDate": "2025-10-06T14:30:00-07:00",
  "items": [
    {
      "itemId": "123456",
      "itemQuantity": 2,
      "itemPrice": "1050",
      "itemNote": "Extra towels requested",
      "subReservationId": "SUB123",
      "payments": [
        {
          "paymentType": "cash",
          "amount": "1050",
          "notes": "Paid at check-in"
        }
      ],
      "modifiers": [
        {
          "modifierOptionId": "9102",
          "quantity": 1
        }
      ]
    }
  ]
}

Response

Items successfully posted

Example response

{
  "data": [
    {
      "soldProductId": "382900",
      "externalRelationId": "382900",
      "transactionStatus": "completed",
      "remainingItemQuantity": 10
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.