For AI agents: visit https://developers.cloudbeds.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.
- Callbacks: All callback endpoints (
BookingCreate, NotifyBooking, ARIFullRefresh, CheckAvailability, RoomInfo, ChannelList) now accept application/json request bodies, and JSON is the documented request format. With a JSON body, booking_json may be embedded directly as a JSON object. Existing integrations using application/x-www-form-urlencoded continue to work.
- Booking Format: Corrected
SeriesCode type from Int >= 0 to String. CardNumber and SeriesCode must be encoded as JSON strings (quoted values), never as bare JSON numbers, so the PCI-compliant secure card endpoint can tokenize them (BookingCreate, GetBookingId).
- BookingCreate, GetBookingId: Documented credit/debit card data handling. Card data is no longer accepted at the standard
BookingCreate endpoint — bookings containing card data must be sent to a dedicated, PCI-compliant endpoint provided by Cloudbeds, authenticated with a Cloudbeds-provided header or an allow-listed IP. A PCI Attestation of Compliance (AoC) is required and the channel must be configured by Cloudbeds before card data can be exchanged. Until a channel is enabled for card handling, bookings with card data are rejected via BookingCreate and silently not imported via GetBookingId.
- UpdateRatePlan: Documented that
min_occupancy and max_occupancy are not currently populated by Cloudbeds (always sent as 0) and should be ignored by partners.
- Taxes: Added
municipal_tax to the tax category enum (CreateProperty, UpdateTaxes).
- Taxes: Added
length-of-stay-progressive and length-of-stay-retroactive to the tax condition_parameter enum (CreateProperty, UpdateTaxes).
- ChannelList: Added new method to get a list of Cloudbeds channels with their IDs and names
- CreateProperty, UpdateRoom, UpdateRatePlan: Added optional
refundable and refundable_until_days fields for a rate plan.
- CreateProperty: Added optional
ota_property_sub_id response parameter. For channels that support multiple properties under one account, this sub-property ID will be saved by Cloudbeds and included in future API calls for the property.
- UpdateProperty: Added new method to update general property data
- CreateProperty, UpdateRoom: Added
max_adults and max_children fields
- Documentation: Improved OpenAPI documentation structure and added new required fields to booking format
- Booking Format: Added new mandatory fields to booking schema
- CreateProperty, UpdateRoom, UpdateRatePlan: Added
meal_codes field to support meal plan information (All-Inclusive, Breakfast, Lunch, Dinner)
- UpdateRoom, UpdateRatePlan: Added mapping return fields in responses to automatically map OTA IDs to Cloudbeds IDs
- Groups: Added group booking support with new methods:
CreateGroup, UpdateGroup, DeleteGroup, CreateGroupBlock, UpdateGroupBlock, DeleteGroupBlock
- Booking Format: Enhanced broker/CRS support with detailed documentation for
OrderSource, OrderSourceId, ExternalReferences, and SourceTree fields
- AckBooking: Added new method to acknowledge successful booking receipt
- Payment: Added support for new card types: Cabal, ItalCred, Naranja, and Nativa
- UpdateRoom: Added missing
ota_room_id field
- Booking Format: Added
DepositType field
- Booking Format: Extended booking format with additional fields
- UpdateRatePlan, DeleteRatePlan: Added new methods for rate plan management
- Room Data: Added gender field to room data for dormitory support
- UpdateRoom, DeleteRoom: Added new methods for room management
- UpdateTaxes: Added new method to manage property taxes and fees
- CreateProperty: Added taxes and fees support in property creation
- Endpoints: Moved to single endpoint URLs (all methods can use the same base URL)
- CreateProperty: Added
rateplans field for rooms
- CreateProperty: Added new fields:
images, description, check_in_time, check_out_time
