API Reference

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

post
https://api.cloudbeds.com/item/v1/items

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Items to post with optional payment information

string | null
required

Reservation identifier. Required if houseAccountId and groupCode are not provided.

string | null

House account identifier. Required if reservationId and groupCode are not provided.

string | null

Group code. Required if reservationId and houseAccountId are not provided.

string | null

Sale date in RFC 3339 format. If not provided, current timestamp will be used.

items
array of objects
required

Array of items to post (minimum 1 item required)

items*
Headers
string
required

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

Responses

Updated 21 days ago

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 21 days ago