Cloudbeds MCP connector

• List List all Cloudbeds oauth metadata Get Cloudbeds OAuth metadata to determine the precise location of the property associated with the provided access token, used for routing requests across multiple localizations. Returns: success, data, message.
• Create Create a Cloudbeds access token Create a Cloudbeds access token to access property resources by querying the authorization server. Supports three grant types: authorization_code, refresh_token, and urn:ietf:params:oauth:grant-type:api-key. Returns: access_token, token_type, expires_in, refresh_token, resources.
• List List all Cloudbeds userinfos Get information about the Cloudbeds user who authorized the current API connection. Returns the user's attributes object including profile details and, when requested, role and ACL details. When role_details is set to true, property_id must also be provided.
• Delete Cloudbeds delete adjustments bulk delete Void an adjustment transaction on a Cloudbeds reservation by specifying the reservation and adjustment identifiers. Returns an empty 204 response on success. Required: reservation_i_d, adjustment_i_d.
• Create Create a Cloudbeds post adjustment Add an adjustment to a reservation in Cloudbeds. Returns: success, data, message. When type is product, fee, or tax, itemID identifies the specific item; itemID is not used for rate.
• Create Create a Cloudbeds create allotment block Create an allotment block in Cloudbeds associated with a group profile or event. Returns: resources. ratePlanId is required when rateType is rate_plan; resources are ignored when the spaces-allotment-blocks flag is off.
• Create Create a Cloudbeds delete allotment block Delete allotment blocks in Cloudbeds by identifying the target block with its property and block code. Returns: success, message.
• List List all Cloudbeds get allotment blocks List allotment blocks in Cloudbeds with optional filters by code, name, status, type, group, event, room type, and date interval. Returns: resources. Required: property_i_d.
• Create Create a Cloudbeds update allotment block Update an allotment block in Cloudbeds by its block code, modifying name, status, allotment type, intervals, auto-release settings, and space resource quotes. Returns: resources.
• Create Create a Cloudbeds create allotment block note Create a note on an allotment block in Cloudbeds. Returns: success, data.
• List List all Cloudbeds list allotment block notes List notes added to an allotment block in Cloudbeds. Returns each note's noteID, text, and status. PageSize must be between 1 and 100. Required: property_i_d, allotment_block_code.
• Create Create a Cloudbeds update allotment block note Update a note on an allotment block in Cloudbeds by modifying its text or status. Returns: success, data, message.
• Create Create a Cloudbeds delete app property setting Delete app property settings in Cloudbeds by submitting a form-encoded request with the property and key identifiers of the setting to remove. Returns a JSON response; the response field structure is not documented in the available API reference.
• List List all Cloudbeds get app property settings Get app property settings for a Cloudbeds property, optionally filtered by a specific key. Returns the app property settings. Required: property_i_d.
• Create Create a Cloudbeds post app property setting Create or set app property settings for a Cloudbeds property by specifying a key-value pair scoped to an application client. Returns: success, data.
• Create Create a Cloudbeds put app property setting Create or update an app property setting in Cloudbeds by supplying a property ID, key, and value. Returns a 200 response; the response body schema is not documented with example fields in the source.
• List List all Cloudbeds get currency settings Get currency settings for a Cloudbeds property. Returns: success, data, message. Accepts an optional propertyID query parameter to target a specific property.
• List List all Cloudbeds get custom fields List custom fields in Cloudbeds. Returns each field with customFieldID, name, shortcode, type, displayed, applyTo, required, maxCharacters, and isPersonal. The displayed array indicates where the field appears (booking engine, reservation folio, or registration cards). Filter by propertyID, customFieldID, or shortcode.
• Create Create a Cloudbeds post custom field Create a custom field in Cloudbeds to add a new field definition to the system. Returns: success, data, message. The call should only be made once per field.
• List List all Cloudbeds get dashboards Get the Cloudbeds hotel dashboard for a given property and date. Returns the hotel dashboard object with basic state information; the exact field set is defined by the GetDashboardResponse schema upstream in Cloudbeds and is not enumerated in the integration's API documentation. Both propertyID and date are optional.
• List List all Cloudbeds get email templates List all existing email templates in Cloudbeds. Returns: name, subject. Only available for third-party integration partners, not for property client IDs.
• Create Create a Cloudbeds post email template Create a new email template in Cloudbeds. Returns the created email template object. This call is only available for third-party integration partners, not for property client IDs. See the Cloudbeds FAQ for the full list of available language parameters.
• List List all Cloudbeds get email schedules List all existing email schedules in Cloudbeds. Returns email schedule records, each including an id and schedule-specific attributes. Only available for third-party integration partners, not for property client IDs.
• Create Create a Cloudbeds post email schedule Create a new email schedule for an existing Cloudbeds email template, triggered by either a reservation status change (e.g., confirmed) or a reservation event offset (e.g., after_check_out). The response shape is not documented in the available source. Exactly one of reservationStatusChange or reservationEvent must be provided (mutually exclusive). Only available for third-party integration…
• List List all Cloudbeds get group notes List group notes for a specific group in Cloudbeds. Returns: success, code, data. Max 100 notes per page. Required: property_i_d, group_code, page_number.
• List List all Cloudbeds get groups List groups for a Cloudbeds property, with optional filters by group code, GPS profile ID, type, status, and creation date range. Returns: name, type, status, created, address1, address2, city, zip, state, contacts. Max 100 groups per page. Required: property_i_d.
• Create Create a Cloudbeds patch group Update an existing group in Cloudbeds by providing new information. At least one information field must be supplied in the form-urlencoded request body. Returns: groupCode, name, type, status, created, sourceID, address1, address2, city, zip, state, id, property_id.
• Create Create a Cloudbeds post group note Add a group note to a Cloudbeds group profile via a form-urlencoded request body. Returns: id, group_profile_id, text, created_by, created_at, updated_at, archived, archived_at.
• Create Create a Cloudbeds put group Create a new group in Cloudbeds by adding it to the property. The default 'Route to Group Folio' setting is set to 'No' and 'Reservation Folio Configuration' uses the default folio configuration; both can be edited via the UI afterward. Returns a JSON response confirming the group was created.
• List List all Cloudbeds get guests Get information about a specific guest in Cloudbeds by reservation ID or guest ID. Returns the guest record including its id and attributes containing guest profile and reservation information. Either reservationID or guestID must be provided.
• List List all Cloudbeds get guest lists List guests in Cloudbeds, ordered by modification date. Returns: success, data, count, total, message. Filterable by property, creation/modification date range, check-in/check-out date ranges, guest details (name, email, phone), and reservation status. Max 100 per page.
• List List all Cloudbeds get guests modifieds List Cloudbeds guests based on their modification date. Returns a list of guest records with guest, reservation, and room details. If no date range is passed, only the current day's records are returned. A guest assigned to multiple rooms produces multiple records. Max 100 results per page.
• List List all Cloudbeds get guests by status List Cloudbeds guests filtered by their current status — Not Checked In, In House, Checked Out, or Cancelled — sorted by modification date. Returns: guestID, reservationID, guestName, roomID, propertyID, status. Max 100 per page. Required: status.
• List List all Cloudbeds get guests by filters List guests in Cloudbeds matching the selected filter criteria such as status, reservation, room, name, and check-in/check-out date ranges. Returns: guestId, reservationID, roomID, guestName, status, checkIn, checkOut. Required: status.
• Create Create a Cloudbeds post guest note Create a guest note in Cloudbeds for a specific guest. Returns: success, guestNoteID, message.
• List List all Cloudbeds get guest notes Retrieve all notes for a specific guest in Cloudbeds. Returns: noteID, text, status, created_at, updated_at. Required: guest_i_d.
• Update Cloudbeds put guest notes bulk update Update an existing guest note in Cloudbeds by providing the guest ID, note ID, and updated note text or status. Returns: success, message.
• Delete Cloudbeds delete guest notes bulk delete Archive an existing guest note in Cloudbeds. Returns a 200 response on success. Required: guest_i_d, note_i_d.
• Update Cloudbeds put guests bulk update Update an existing guest in Cloudbeds with the information provided. At least one information field must be supplied in the request body. Returns: success, message.
• Create Create a Cloudbeds post guest document Attach a document to a guest in Cloudbeds by uploading a file via multipart form-data. Returns: success, message, data. Response field structure is defined in the upstream PostGuestDocumentResponse schema and is not fully enumerated in the available documentation.
• Create Create a Cloudbeds post guest Add an additional guest to an existing Cloudbeds reservation. Returns a JSON response confirming the guest was added to the reservation. The request body is form-encoded with guest and reservation details; see the Cloudbeds API reference for the full parameter list.
• Create Create a Cloudbeds post guests to room Assign guest(s) to a room in a Cloudbeds reservation, adding them as additional guests. Returns the guest-to-room assignment result. Request body is sent as form-urlencoded fields.
• Create Create a Cloudbeds post guest photo Attach a photo to a guest in Cloudbeds. The request body is sent as multipart/form-data containing the guest identifier and photo file. Returns: success, message, data.
• List List all Cloudbeds get hotels List hotels in Cloudbeds, optionally filtered by property IDs, name, or city. Returns: success, data (array of hotel records each containing propertyID).
• List List all Cloudbeds get hotel details Get the details of a specific Cloudbeds hotel (property) identified by propertyID. Returns: success, data.
• Create Create a Cloudbeds post file Attach a file to a hotel in Cloudbeds by uploading it as a multipart form body. Returns: success, message, data.
• List List all Cloudbeds get files List files attached to a hotel or group profile in Cloudbeds, ordered by creation date. Returns each file's name, type, source, and date. Max 100 results per page.
• List List all Cloudbeds get house account lists List active house accounts for a Cloudbeds property. Returns: success, data (array of house account records, each containing an id).
• Create Create a Cloudbeds post new house account Create a new house account in Cloudbeds by submitting form-encoded account data. Returns a JSON response confirming creation; the specific response fields are not documented in the available source.
• Update Cloudbeds put house account status bulk update Update a specific Cloudbeds house account's status to either open or closed. Returns: success, message.
• List List all Cloudbeds get housekeeping status List current-day housekeeping status for rooms in Cloudbeds. Returns per-room status including roomOccupied, roomCondition, roomBlocked, vacantPickup, refusedService, and doNotDisturb. Filter by property, room type, housekeeper, condition, or occupancy. Max page size 5000.
• Create Create a Cloudbeds post housekeeping status PostHousekeepingStatus. Returns: success, data, message.
• Create Create a Cloudbeds post housekeeper Add a new housekeeper in Cloudbeds by submitting form-encoded data. Returns a JSON response with the result of the creation request. The request body is sent as application/x-www-form-urlencoded.
• Update Cloudbeds put housekeepers bulk update Edit housekeeper details in Cloudbeds. Returns the updated housekeeper record with fields defined by the upstream PutHousekeeperResponse schema; the specific response fields are not enumerated in the available source — consult the Cloudbeds API reference for the complete field list. The request body uses form-urlencoded fields defined by the upstream PutHousekeeperRequest schema.
• List List all Cloudbeds get housekeepers List housekeepers for one or more Cloudbeds properties. Returns a list of housekeeper records with their identifiers and details per the GetHousekeepersResponse schema. Supports querying across multiple properties with comma-separated property IDs. Max 1000 results per page.
• Create Create a Cloudbeds post housekeeping assignment Assign rooms (single or multiple) to an existing housekeeper in Cloudbeds. Returns a JSON response confirming the assignment; the specific response fields are not documented in the available source. The request body is sent as application/x-www-form-urlencoded.
• List List all Cloudbeds get app states Get the current Cloudbeds app integration state for a property. Returns: success, data. Only available for third-party integration partners, not property client IDs.
• Create Create a Cloudbeds post app state Update the app integration state for a property in Cloudbeds. Setting the state to 'disabled' removes all active sessions for the app. Returns: success. Only available for third-party integration partners, not property client IDs.
• Create Create a Cloudbeds post government receipt Add a Government Receipt to a reservation or house account in Cloudbeds. Returns the created government receipt response.
• List List all Cloudbeds get app settings Get the current app settings for a property in Cloudbeds. Returns the app settings data object whose fields are integration-specific and depend on the app's configuration. Accepts an optional propertyID to target a specific property.
• Create Create a Cloudbeds post app error Submit an application error received by a hybrid integration from the partner to Cloudbeds MFD. The request body is sent as application/x-www-form-urlencoded; specific request and response field names are not documented in the available source.
• Create Create a Cloudbeds post webhook Subscribe a webhook to a specified Cloudbeds event so your endpoint URL receives notifications when the event occurs. Returns: success, data. You must subscribe to a specific action; Cloudbeds does not support subscribing to all actions on a given object.
• Delete Cloudbeds delete webhooks bulk delete Delete a webhook subscription in Cloudbeds by its subscription ID, which can be obtained by listing existing webhooks via getWebhooks. Returns: success. Required: subscription_i_d.
• List List all Cloudbeds get webhooks List webhook subscriptions the API client is subscribed to in Cloudbeds. Returns: id, key, event, owner, subscriptionType, subscriptionData. Optional: propertyID.
• List List all Cloudbeds get items List all items and their prices created in Cloudbeds myfrontdesk. Returns: sku, name, description, price, taxes, fees. Taxes, fees, and totals appear only when items have assigned tax or fee.
• Get Get single Cloudbeds get item by ID Get details for a single Cloudbeds item by itemID. Returns: success, data, message. Stock inventory fields appear only when data.stockInventory is true; taxes, fees, and totals appear only when the item has assigned tax or fee. Required: item_i_d.
• Update Cloudbeds put item to inventories bulk update PutItemToInventory. Returns: success, message.
• List List all Cloudbeds get item categories List item categories in Cloudbeds. Returns: success, and data (an array of item category objects).
• Create Create a Cloudbeds post item category Create a new item category in Cloudbeds by submitting form-urlencoded data. Returns a 200 response on success.
• Create Create a Cloudbeds post items to inventory Create a batch of new inventory items in Cloudbeds. Returns: success, data. Stock-related fields on the created items are populated only when the item's stockInventory flag is true.
• Create Create a Cloudbeds post item Add an item to a reservation or house account in Cloudbeds. Returns the posted item response object with fields defined by the PostItemResponse schema. The form-urlencoded request body specifies the target reservation or house account and item details per the PostItemRequest schema.
• Create Create a Cloudbeds post custom item Add single or multiple custom items and their associated payments to a Cloudbeds reservation or house account as a single transaction. Accepts a form-encoded request body defined by the upstream PostCustomItemRequest schema. Returns a JSON response whose fields are defined by the upstream PostCustomItemResponse schema and are not enumerated in the available source documentation.
• Create Create a Cloudbeds append custom item Append one or more custom items and their associated payments to an existing item in a Cloudbeds reservation, house account, or group. Returns a response object whose fields are defined by the upstream PostAppendCustomItemResponse OpenAPI schema; the request body is sent as application/x-www-form-urlencoded per the upstream PostAppendCustomItemRequest schema.
• Create Create a Cloudbeds post void item Void an item transaction in Cloudbeds by itemID on a specified reservation, house account, or group. Payments previously posted via postItem or postCustomItem for the voided item are also deleted. Returns: success, message. One of reservationID, houseAccountID, or groupID must also be provided.
• List List all Cloudbeds get packages List the packages associated with a Cloudbeds property, where each package defines a group of features the property can utilize or access. Returns the packages response object whose field structure is defined by the GetPackagesResponse schema; consult the Cloudbeds API reference for the field-level breakdown.
• List List all Cloudbeds get package names List billing package names for a Cloudbeds property. Returns a JSON response containing billing package names for the specified property; the exact response schema (GetPackagesResponse) is not fully documented in the available source.
• Create Create a Cloudbeds post payment Add a payment to a specified reservation, house account, or group in Cloudbeds. At least one of reservationID, houseAccountID, or groupCode must be provided; if multiple are given, precedence is reservationID, then houseAccountID, then groupCode. Returns a 200 response with the payment result (response schema not documented in the available source).
• Create Create a Cloudbeds post custom payment method Add a custom payment method to a Cloudbeds property. This call does not support adding credit cards, bank transfer, or PayPal as payment methods. Returns a confirmation response for the created custom payment method.
• List List all Cloudbeds get payment methods List active payment methods for a Cloudbeds property or list of properties. Returns: success, data.
• List List all Cloudbeds get payments capabilities List the payment capabilities of a given Cloudbeds property. Returns the payment capabilities object with fields defined by the upstream GetPaymentsCapabilitiesResponse schema; the exact field set is not enumerated in the available source. The optional propertyID query parameter specifies the property to query.
• Create Create a Cloudbeds post void payment Void a payment in Cloudbeds by its paymentID, for a payment associated with a reservation or house account. Returns: success, message.
• Create Create a Cloudbeds post charge Process a payment using a payment method on a Cloudbeds reservation, group profile, accounts receivable ledger, or house account. Returns: success, data.
• Create Create a Cloudbeds post credit card Post a credit card in Cloudbeds to store payment details. Accepts a form-encoded request body per the PostCardRequest schema and returns a JSON response per the PostCardResponse schema. Field definitions are available in the upstream OpenAPI specification.
• List List all Cloudbeds get rates Get the rate for a specific Cloudbeds room type based on check-in/check-out dates and occupancy. Returns the rate response object with rate details for the selected room type and date range. The promoCode parameter is deprecated; use getRatePlans instead. Required: room_type_i_d, start_date, end_date.
• List List all Cloudbeds get rate jobs List rate jobs in Cloudbeds. Returns each rate job with its jobReferenceID and status. Rate jobs are only returned within 7 days of creation; without a jobReferenceID filter, results are scoped to the request token's client ID.
• List List all Cloudbeds get rate plans List Cloudbeds rate plans filtered by property, room type, rate IDs, or promo code for a given date range. Returns: ota_room_id, ota_rate_id, title. Required: start_date, end_date.
• Get Get single Cloudbeds get rate plan by ID Retrieve rate plans from the Cloudbeds OTA channel manager, either specific to each room or global for all rooms. Returns: success and RatePlans (each item with ota_room_id, ota_rate_id, title). Required: verb.
• Create Create a Cloudbeds patch rate Update room rates in Cloudbeds by rateID within an optional date interval. Supports multiple updates per call (max 30 intervals); only non-derived rates can be patched. Returns: success, jobReferenceID, message.
• Create Create a Cloudbeds put rate Update room rates in Cloudbeds by rateID with optional date interval filtering. Returns: success, jobReferenceID, message. Only non-derived rates can be updated; max 30 intervals per call. Processing is asynchronous—use the returned jobReferenceID to track job status.
• List List all Cloudbeds get reservations List Cloudbeds reservations matching filter criteria such as status, date ranges, room, guest, or source. Returns: status, adults, children, balance, rooms, origin. Max 100 per page.
• Get Get single Cloudbeds get reservation by ID Get a single Cloudbeds reservation by reservationID. Returns: success, data, message. Required: reservation_i_d.
• Create Create a Cloudbeds post reservation Create a new reservation in Cloudbeds for a selected property. Returns the created reservation's reservationID, startDate, endDate, and propertyID.
• List List all Cloudbeds get reservations with rate details List Cloudbeds reservations with booked rate and source details. Returns: status, source, rooms, origin, total, balance. Max 100 results per page; includeGuestRequirements requires includeGuestsDetails=true.
• List List all Cloudbeds get reservation assignments List rooms and reservations assigned for a selected date in Cloudbeds. Returns the assignments for the specified date, defaulting to the current day when no date is provided. Both propertyID and date are optional.
• Create Create a Cloudbeds post reservation note Add a reservation note in Cloudbeds. Accepts a form-encoded request body. Returns a JSON response whose fields are not documented in the available API reference.
• List List all Cloudbeds get reservation notes List reservation notes for a specific reservation in Cloudbeds. Returns the notes associated with the reservation including each note's reservationNoteID and note content. Required: reservation_i_d.
• Update Cloudbeds put reservation notes bulk update Update an existing reservation note in Cloudbeds with new content. Returns: success, message.
• Delete Cloudbeds delete reservation notes bulk delete Archive an existing reservation note in Cloudbeds by reservation and note identifier. The API returns a 200 response confirming the operation. Required: reservation_i_d, reservation_note_i_d.
• Create Create a Cloudbeds post reservation document Attach a document to a reservation in Cloudbeds by uploading a file as multipart form data. Returns a JSON response from the Cloudbeds API; the specific response fields are not documented in the available source.
• Update Cloudbeds put reservations bulk update Update a Cloudbeds reservation to modify custom fields, estimated arrival time, room configuration, or reservation status. Returns: success, message, data.
• List List all Cloudbeds get sources List available property sources in Cloudbeds, optionally filtered by one or more property IDs. Returns the available property sources for the queried properties. The propertyIDs parameter accepts a comma-separated list of property IDs (e.g. 37,345,89). The response field structure is defined in the GetSourcesResponse schema; consult the Cloudbeds API reference for field-level details.
• List List all Cloudbeds get rooms fees and taxes Get applicable fees and taxes for a Cloudbeds booking, meant for checkout display to the guest. Returns the computed fees and taxes object whose field structure is defined by the GetRoomsFeesAndTaxesResponse schema in the Cloudbeds API. adultsPerRoom is needed for fixed_per_person taxes/fees to return non-zero amounts. Required: start_date, end_date, rooms_total, rooms_count.
• Create Create a Cloudbeds post room assign Assign or reassign a room on a guest reservation in Cloudbeds. Returns: success, message.
• Create Create a Cloudbeds post room check in Check-in a room already assigned for a guest in Cloudbeds. Submits form-urlencoded data to perform the room check-in and returns a JSON response confirming the operation.
• Create Create a Cloudbeds post room check out Check out a room already assigned to a guest in Cloudbeds. If all rooms on the reservation are checked out, the reservation status automatically updates to 'Checked Out' as well. Returns a JSON response confirming the check-out operation.
• List List all Cloudbeds get reservation room details GetReservationRoomDetails. Returns: success, message, data. Required: sub_reservation_i_d.
• Create Create a Cloudbeds post room block Create a room block on a Cloudbeds property by specifying the block type, date range, and rooms to block. Returns: success, rooms, message.
• List List all Cloudbeds get room blocks List room blocks in Cloudbeds, filterable by property, room block, room type, room, or date range. Returns: success, data, count, total, message. The date range between startDate and endDate must be 35 days or less.
• Update Cloudbeds put room blocks bulk update Update a room block in Cloudbeds. Returns the updated room block object including roomBlockID, propertyID, roomBlockType, roomBlockReason, startDate, endDate, and rooms.
• Create Create a Cloudbeds delete room block Delete a room block in Cloudbeds by providing its room block ID. Returns: success, message.
• List List all Cloudbeds get room types List Cloudbeds room types with optional filters by property, dates, occupancy, and other criteria. Returns: roomTypeID, roomTypeName, propertyName, propertyCity, maxGuests. Rates are only included when startDate, endDate, adults, and children are all provided.
• Get Get single Cloudbeds get room type by ID Retrieve rooms configured for the passed OTA credentials in Cloudbeds. Returns: success, Rooms (each room includes ota_room_id, title, occupancy, dorm). Required: verb.
• List List all Cloudbeds get available room types List available room types in Cloudbeds for a given date range and occupancy. Returns available room types with pricing and availability details for the specified stay period. Required: start_date, end_date, rooms, adults, children.
• List List all Cloudbeds get rooms List rooms in Cloudbeds, optionally filtered by property, room type, and stay dates. Returns: rooms. If check-in/out dates are sent, only unassigned rooms are returned.
• List List all Cloudbeds get rooms unassigneds List unassigned rooms in a Cloudbeds property. This endpoint is an alias of getRooms; the response shape follows that endpoint. Returns: rooms.
• List List all Cloudbeds get taxes and fees List the taxes and fees configured for a property in Cloudbeds. Returns: type, name, code, kind, amount, createdAt, id, description. All parameters are optional. When sourceId is supplied, isRootSource and isHotelCollectBooking must also be provided; productId and addonId are mutually exclusive.
• List List all Cloudbeds get users List users for Cloudbeds properties, optionally filtered by one or more property IDs. The upstream GetUsersResponse schema is referenced but not documented in the available API source.
• List List all Cloudbeds v 1 0 settings Get the accounting settings for a Cloudbeds property, such as the deposit consumption policy. Returns: the accounting settings object controlling accounting behaviors across the property.
• Update Cloudbeds v 1 0 settings bulk update Update one or more accounting settings for a Cloudbeds property; only include the fields you want to change. If no settings exist for the property, they are created automatically. Returns: the updated accounting settings object.
• Create Create a Cloudbeds deposits transfer Transfer one or more Cloudbeds deposit transactions to the guest ledger by providing the transaction IDs of the deposits to transfer in the request body. The operation is processed asynchronously and returns an event ID you can use to track the result.
• List List all Cloudbeds v 1 0 accounts receivable ledgers List accounts receivable ledgers for a Cloudbeds property. Returns: id, description. Supports filtering by status, date range, balance range, profile, and search query.
• Create Create a Cloudbeds v 1 0 accounts receivable ledger Create a new accounts receivable ledger in Cloudbeds to track outstanding balances outside of a reservation, such as invoices sent to a corporate client. Returns: id, description. Required: name.
• Get Get single Cloudbeds v 1 0 accounts receivable ledger by ID Get a single accounts receivable ledger from Cloudbeds by id. Returns: id, description. Required: id.
• Update Cloudbeds v 1 0 accounts receivable ledgers bulk update Update an existing accounts receivable ledger in Cloudbeds — change the name, description, linked profile, or status. Returns: id, description. Required: id. A ledger can only be closed (status set to CLOSED) when its balance is zero.
• List List all Cloudbeds accounts receivable ledger transactions List transactions for a specific Cloudbeds accounts receivable ledger. Returns a paginated list of AR ledger transactions including their state (posted or pending), dates, and type. Required: accounts_receivable_ledger_id.
• List List all Cloudbeds accounts receivable ledgers totals Get aggregated totals across all accounts receivable (AR) ledgers for a Cloudbeds property. Returns: totalCharges, amountPaid, outstandingBalance. Optionally filter by status for open or closed ledgers.
• Create Create a Cloudbeds balance transfer Transfer a reservation's outstanding balance to an accounts receivable ledger in Cloudbeds. Returns an async event response with the event_id for tracking the result. Required: accounts_receivable_ledger_id, reservation_id. Processed asynchronously.
• List List all Cloudbeds balance transfers Get AR balance transfer details for a specific reservation in Cloudbeds. Returns: transaction_id, amount, accounts_receivable_ledger_id. Required: reservation_id.
• Delete Cloudbeds balance transfers bulk delete Reverse a previously created reservation-to-AR balance transfer in Cloudbeds, moving the balance back to the original reservation. Returns an async event response with the event_id for tracking. Required: accounts_receivable_ledger_id, reservation_id. Processed asynchronously.
• Create Create a Cloudbeds group profile balance transfer Transfer the outstanding balance of a Cloudbeds group profile to an accounts receivable (AR) ledger. Optionally specify a folio ID to transfer from a specific folio within the group profile. This operation is processed asynchronously. Returns: eventId. Required: accounts_receivable_ledger_id, group_profile_id.
• List List all Cloudbeds v 1 0 custom general ledger codes List all custom general ledger (GL) codes configured for a Cloudbeds property, used to map Cloudbeds transaction categories to your own chart-of-accounts structure for reporting and export. Returns: id.
• Update Cloudbeds v 1 0 custom general ledger codes bulk update Create or update custom general ledger (GL) codes for a Cloudbeds property by sending the full list of codes to persist; each code must have a unique name and code value, and can be assigned to a group or archived. Returns an empty 200 response on success. Required: name, code.
• List List all Cloudbeds v 1 0 custom transaction codes List custom transaction code mappings for a Cloudbeds property. Custom transaction codes let you assign your own codes to each internal transaction type (e.g., room rate, tax, payment method). Returns: id. You must call the initialize endpoint before codes can be retrieved for the first time.
• Update Cloudbeds v 1 0 custom transaction codes bulk update Update custom transaction code mappings for a Cloudbeds property. For each mapping, provide the record ID and the new custom code value; a custom general ledger code can optionally be assigned. Only the mappings included in the request are updated; others remain unchanged. Required: id, customCode (per mapping). Returns an empty 200 response on success.
• Create Create a Cloudbeds custom transaction codes initialize Initialize custom transaction code records for a property in Cloudbeds. Must be called before retrieving or updating custom transaction codes; creates a record for each internal transaction type with an empty custom code mapping. Has no additional effect if codes have already been initialized. Returns an empty 200 response on success.
• List List all Cloudbeds v 1 0 transactions Search posted transactions in Cloudbeds with complex AND/OR filter criteria, sorting, and cursor-based pagination. Returns: id. Required: filters. Every request must include at least one base filter (id with equals/in, source_id with source_kind, transaction_datetime, service_date, or trial_balance_id).
• List List all Cloudbeds v 1 0 folios List all folios for a given source (reservation, group profile, or configuration) in Cloudbeds. Folios organize transactions into logical groups, such as separating room charges from incidentals. Returns: id, name, isDefault. Required: sourceId, sourceKind. Both sourceId and sourceKind must be provided together to identify the source.
• Create Create a Cloudbeds v 1 0 folio Create a new folio in Cloudbeds for a reservation, group profile, or configuration source. Returns the created folio including its id, name, source, and assigned transaction types. Required: name, source details, and transaction types in the request body. The optional propagateDownstream query parameter, when true with a CONFIG source, creates matching child folios for active reservations and…
• Update Update a Cloudbeds v 1 0 folio by ID Update an existing Cloudbeds folio by id, changing the folio name and the transaction types assigned to it. Returns an empty 204 response on success. Required: id. Only the name and transaction types can be modified; source and configuration cannot be changed after creation.
• Delete Delete a Cloudbeds v 1 0 folio by ID Delete a Cloudbeds folio by id. The folio is soft-deleted and no longer appears in listings. Returns an empty 204 response on success. Required: id. Cannot delete a folio that still has transactions assigned to it; move or unroute all transactions first.
• Create Create a Cloudbeds transactions move Move transactions to a different folio within the same source in Cloudbeds. Accepts individual transaction IDs or transaction types (by origin ID and external relation kind) to move all matching transactions at once. Returns an empty 200 response on success. At least one of transactions or transactionTypes must be provided.
• Create Create a Cloudbeds transactions route Route Cloudbeds reservation transactions to a group profile folio, binding them to the group profile and assigning them to the specified folio. Specify individual transaction IDs via transactions or matching transaction types via transactionTypes (by origin ID and external relation kind); at least one of the two is required. Returns an empty 200 response on success.
• Create Create a Cloudbeds transactions unroute Unroute transactions from a Cloudbeds group profile back to their original reservation, reversing a previous routing operation. Returns a 200 OK response with no response body on success. Only individual transaction IDs are accepted; transaction types are not supported.
• List List all Cloudbeds v 1 0 pending transactions Search and retrieve pending (not yet posted) transactions for a Cloudbeds property using POST-based filter criteria. Returns a paginated list of transactions with id, transaction_datetime, service_date, customer_id, source_id, source_kind, and internal_code. Required: filters — must include at least one base filter (e.g., id with equals/in, source_id together with source_kind, or…
• List List all Cloudbeds folios transactions Search posted and pending folio transactions for a Cloudbeds source (reservation, group profile, or house account) using POST-based filter and grouping criteria. Returns: id, description. Results are always wrapped in groups; groups at page boundaries may be partial.
• List List all Cloudbeds folios summaries List Cloudbeds folio balance summaries for a given source (reservation or group profile). Each entry contains the folio's ID and balance due, computed from posted and pending transactions assigned to the folio. Returns: folioId, balanceDue. Required: sourceId, sourceKind.
• List List all Cloudbeds configuration status Check whether a property has configured its trial balance in Cloudbeds. Returns: is_configured, configuration_date. The trial balance must be configured before daily reports can be generated.
• Create Create a Cloudbeds configuration calculate Calculate the initial trial balance for a Cloudbeds property based on all historical transactions through the end of yesterday (property local time). Returns the computed opening balances for the deposit ledger, accounts receivable ledger, and guest ledger, plus the configuration date. Use this endpoint to preview opening balances before committing the trial balance configuration.
• List List all Cloudbeds trial balance configurations Retrieve the saved trial balance configuration for a Cloudbeds property, including opening balances for the deposit, accounts receivable, and guest ledgers. Returns: configurationDate, depositLedger, accountsReceivableLedger, guestLedger.
• Create Create a Cloudbeds trial balance configuration Configure the trial balance for a Cloudbeds property by saving opening balances as of today. Returns: configurationDate, depositLedger, accountsReceivableLedger, guestLedger. Required: depositLedger, accountsReceivableLedger, guestLedger. Can only be performed once per property; returns an error if a configuration already exists.
• List List all Cloudbeds deposits balances Get the deposit balance for a specific source or the entire Cloudbeds property. Returns: postedBalance, pendingBalance (both expressed in the smallest currency unit). When sourceId is provided, sourceKind must also be supplied; omit both for the aggregate property-wide balance.
• List List all Cloudbeds deposits transactions List Cloudbeds deposit transactions for a property with filters for transaction state, reservation, date ranges, reservation status, and user. Returns: id, createdAt.
• List List all Cloudbeds trial balance reports Retrieve the trial balance report for a specific date in Cloudbeds. Returns the report data including opening and closing balances, ledger activity, deposit and AR transfers, and a detailed breakdown of guest ledger charges, taxes, and payments by transaction code. Required: date. The property must have a configured trial balance before reports can be generated.
• List List all Cloudbeds v 1 0 internal transaction codes List all Cloudbeds internal transaction codes — system-defined codes that categorize each type of transaction such as room rate, tax, fee, and payment. Returns: internalTransactionCode. These codes are read-only and can be mapped to custom codes via the custom transaction codes endpoints.
• List List all Cloudbeds v 1 0 source balances Get the financial balance summary for a specific Cloudbeds source (reservation, house account, group profile, or accounts receivable ledger). Returns a detailed breakdown including charges, payments, refunds, upcoming payments, and balance due. Required: source_kind, source_id.
• Get Get single Cloudbeds source balances snapshot by ID Get a source balance snapshot for a specific reservation in Cloudbeds. Returns a financial balance summary including charges, payments, refunds, upcoming_payments, and balance_due. Required: id (reservation ID).
• List List all Cloudbeds folios configurations List all folio configurations for a property in Cloudbeds. Returns: id, description. The optional includeFolios parameter controls whether folios and their transaction types are included in the response.
• Update Cloudbeds folios configurations bulk update Create or update a folio configuration in Cloudbeds. To update an existing configuration, include its id in the request body. Returns: id, name, description, isDefault, folios. The optional propagateDownstream parameter controls whether changes propagate to downstream reservation and group folios.
• Get Get single Cloudbeds folios configuration by ID Get a single folio configuration by id in Cloudbeds. Returns: id, description. Required: id. The optional includeFolios parameter controls whether folios and their transaction types are included.
• Update Update a Cloudbeds folios configuration by ID Partially update a folio configuration in Cloudbeds. Only provided fields are updated. Returns: id, name, description, isDefault, folios. Required: id.
• Delete Delete a Cloudbeds folios configuration by ID Delete a folio configuration by id in Cloudbeds. The default configuration cannot be deleted; set another configuration as default first. Existing folios created from this configuration are not affected. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds configurations sources Get which folio configuration is assigned to a source in Cloudbeds. Returns: sourceId, sourceKind, folioConfigurationId. Required: sourceId, sourceKind.
• Update Cloudbeds configurations sources bulk update Assign a folio configuration to a source in Cloudbeds, replacing existing folios for that source. Returns the updated folio configuration to source assignment including sourceId, sourceKind, and folioConfigurationId. Requires a JSON request body with the assignment details.
• List List all Cloudbeds folios rules List Cloudbeds autorouting rules configured for a group profile. Returns an array of routing rules, each including id, sourceId, sourceKind, and subSourceId. Required: sourceId. The sourceKind parameter is deprecated and defaults to GROUP_PROFILE.
• Create Create a Cloudbeds folios rule Create a new Cloudbeds autorouting rule for a group profile that defines which transaction types are automatically routed from reservations to a group profile folio. Returns the created rule including id, sourceId, sourceKind, and subSourceId. Required: sourceId.
• Update Cloudbeds folios rules bulk update Update or create Cloudbeds autorouting rules for a group profile. Entries with an id are updated; entries without an id are created as new rules. Returns the updated rule including id, sourceId, sourceKind, and subSourceId. Required: sourceId.
• List List all Cloudbeds transactions filters Get the structured filter tree of routable transaction types for folio configuration in Cloudbeds. Returns: debit, credit — each a pre-assembled tree of localized filter nodes used to pick transaction types to route into a folio. Labels are localized via the Accept-Language header.
• List List all Cloudbeds attribute tagging attributes List attribute tagging attributes in Cloudbeds. Returns: id, label, description, entityTypes, isEnabled. Supports filtering by entityTypes and sorting by label, createdAt, or updatedAt.
• Create Create a Cloudbeds attribute tagging attribute Create a new attribute tagging attribute in Cloudbeds. Returns: id, label, description, entityTypes, isEnabled. Required: label, entityTypes.
• Update Update a Cloudbeds attribute tagging attribute by ID Update an existing attribute tagging attribute in Cloudbeds by id. Returns: id, label, description, entityTypes, isEnabled. Required: id.
• Delete Delete a Cloudbeds attribute tagging attribute by ID Delete a Cloudbeds attribute tagging attribute by id. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds attribute tagging tags List attribute tags for Cloudbeds entities. Returns: id. Filter by entityId and entityType individually, or use the filters parameter for bulk queries supporting up to 500 entities per request.
• Create Create a Cloudbeds attribute tagging tag Attach attribute tags to a Cloudbeds entity. Returns an array of created tag objects including id, entityId, entityType, propertyId, attributeId, and a nested attribute object. Required: entityId, entityType, attributeIds.
• Delete Cloudbeds attribute tagging tags bulk delete Delete multiple attribute tags in Cloudbeds by providing a list of tag IDs. Returns an empty 204 response on success. Required: ids.
• Delete Delete a Cloudbeds attribute tagging tag by ID Delete a single attribute tag in Cloudbeds by id. Returns an empty 204 response on success. Required: id.
• Create Create a Cloudbeds tags query Bulk-lookup tags for a list of Cloudbeds entities grouped by type. Returns an array of tag objects including id, entityId, entityType, propertyId, attributeId, and a nested attribute object with id, label, description, entityTypes, and isEnabled. Required: entities. Total ids across all groups must not exceed 1000.
• List List all Cloudbeds group profile profiles List all Cloudbeds group profiles across all types (company, group, or travel agent) with optional filters by status, profile type, name, or code. Returns: id, code, name, status, profileType, createdAt, updatedAt.
• Create Create a Cloudbeds group profile profile Create a new Cloudbeds group profile (company, group, or travel agent) based on the attributes provided in the request body. Returns the created profile including id, code, name, status, profileType, address, billing details, and type-specific attributes. Required: code, name, status, attributes.
• Get Get single Cloudbeds group profile profile by ID Get a single Cloudbeds group profile by id. Returns the full profile object including id, code, name, status, profileType, address, billing details, and type-specific attributes. Required: id.
• Update Update a Cloudbeds group profile profile by ID Update a Cloudbeds group profile by id. The profile type is determined from existing data and cannot be changed. Returns the updated profile including id, code, name, status, profileType, address, billing details, and type-specific attributes. Required: id.
• Delete Delete a Cloudbeds group profile profile by ID Delete a Cloudbeds group profile by id. The profile type is automatically determined. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds profile people List all persons (contacts and guests) linked to a Cloudbeds profile. Returns: createdAt, updatedAt. Required: profile_id. Default sort is createdAt:desc.
• Create Create a Cloudbeds profile person Create a new person relationship (contact or guest) for a Cloudbeds profile. Returns: profileId, personId, personType, role, startDate, createdAt, updatedAt. Required: profile_id, personId, personType.
• Delete Delete a Cloudbeds profile person by ID Unlink a person from a Cloudbeds profile by id. Returns an empty 204 response on success. Required: id, profile_id, personType.
• Get Get single Cloudbeds profiles person by ID Find all Cloudbeds profile relationships where a person is the target (reverse lookup). Returns a list of profile-person relationships including profileId, personId, personType, role, startDate, createdAt, and updatedAt. Required: id, personType.
• List List all Cloudbeds group profile contact persons List Cloudbeds group profile contact persons, optionally filtered by IDs, profile, name, or email. Returns: id, createdAt, updatedAt. Default sort: lastName:asc; valid sort fields include firstName, lastName, email, createdAt, and updatedAt.
• Create Create a Cloudbeds group profile contact person Create a new contact person in Cloudbeds and add it to a group, company, or travel agent profile. Returns: id, createdAt, updatedAt.
• Get Get single Cloudbeds group profile contact person by ID Get a single Cloudbeds contact person by id. Returns: id, createdAt, updatedAt. Required: id.
• Update Update a Cloudbeds group profile contact person by ID Update a Cloudbeds contact person by id. Returns: id, createdAt, updatedAt. Required: id.
• Delete Delete a Cloudbeds group profile contact person by ID Delete a Cloudbeds contact person by id. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds profile notes List notes for a Cloudbeds profile (group, company, or travel agent). Returns each note with id, profileId, userId, content, createdAt, and updatedAt. Required: profile_id. Defaults to returning only active notes unless the archived filter is set to ARCHIVED or ALL.
• Create Create a Cloudbeds profile note Create a new note for a Cloudbeds profile (group, company, or travel agent). Returns the created note including id, profileId, userId, content, createdAt, and updatedAt. Required: profile_id, content.
• Update Update a Cloudbeds profile note by ID Update an existing note for a Cloudbeds profile. Returns the updated note including id, profileId, userId, content, createdAt, and updatedAt. Required: profile_id, id.
• Delete Delete a Cloudbeds profile note by ID Delete a note from a Cloudbeds profile. Returns an empty 204 response on success. Required: profile_id, id.
• Archive Cloudbeds profile notes archive Archive a Cloudbeds profile note by setting the archived_at timestamp. Returns the archived note including id, profileId, userId, content, createdAt, and updatedAt. Archived notes can be restored later. Required: profile_id, note_id.
• Restore Cloudbeds profile notes restore Restore an archived Cloudbeds profile note by unsetting the archived_at timestamp. Returns the restored note object including id, profileId, userId, content, createdAt, and updatedAt. Required: profile_id, note_id.
• Get Get single Cloudbeds profile note by ID Get a specific Cloudbeds profile note by id. Returns the note object including id, profileId, userId, content, createdAt, and updatedAt. Required: profile_id, id.
• Delete Delete a Cloudbeds profile tag by ID Delete a tag from a Cloudbeds group profile. Returns an empty 204 response on success. Required: profile_id, id.
• List List all Cloudbeds profile tags List all tags assigned to a Cloudbeds group profile. Returns: id, profileId, tag. Required: profile_id.
• Create Create a Cloudbeds profile tag Assign a tag to a Cloudbeds group profile. Returns: id, profileId, tag. Required: profile_id, tag.
• List List all Cloudbeds profile documents List all documents for a Cloudbeds profile (group, company, or travel agent). Returns: id, fileName, createdAt, updatedAt. Required: profile_id. Default sort is createdAt:desc; valid sort fields are fileName, createdAt, and updatedAt.
• Create Create a Cloudbeds profile document Upload one or more documents to a Cloudbeds profile. Returns: id, fileName, createdAt, updatedAt. Required: profile_id, files, userId. Maximum 10MB per file; allowed types: .png, .doc, .docx, .xls, .xlsx, .pdf, .jpg, .jpeg, .gif, .csv.
• Delete Delete a Cloudbeds profile document by ID Delete a document from a Cloudbeds profile by id. Returns an empty 204 response on success. Required: profile_id, id.
• Get Get single Cloudbeds profile document by ID Get metadata for a specific Cloudbeds profile document by id. Returns: id, fileName, createdAt, updatedAt. Required: profile_id, id.
• List List all Cloudbeds document downloads Get a pre-signed download URL for a Cloudbeds profile document file. Returns: downloadUrl. The URL is valid for 5 minutes. Required: profile_id, document_id.
• List List all Cloudbeds profiles List guest profiles in Cloudbeds. Returns: id, organizationId, photoId, taxId, companyTaxId, statusId, statusName, firstName, lastName, email, phone, cellPhone, birthday, gender, companyName, address1, address2, city, country, countryName, state, zip, documentType, documentNumber, documentIssueDate, documentIssuingCountry, documentExpirationDate, isOptIn, isMerged, isRepeatGuest.
• Create Create a Cloudbeds profile Create a new guest profile in Cloudbeds. Returns the created profile including id, firstName, lastName, email, phone, country, dateCreated, dateModified, and photo.
• Get Get single Cloudbeds profile by ID Get a single guest profile by id in Cloudbeds. Returns: id, organizationId, photoId, taxId, companyTaxId, statusId, statusName, firstName, lastName, email, phone, cellPhone, birthday, gender, companyName, address1, address2, city, country, countryName, state, zip, documentType, documentNumber, documentIssueDate, documentIssuingCountry, documentExpirationDate, isOptIn, isMerged, isRepeatGuest,…
• Update Update a Cloudbeds profile by ID Update a guest profile by id in Cloudbeds. Returns the updated profile including id, firstName, lastName, email, phone, country, dateCreated, dateModified, and photo. Required: id and a request body with profile attributes to update.
• List List all Cloudbeds profile pii fields Get the value of a personally identifiable information (PII) field for a specific Cloudbeds profile. Returns: value. Required: profile_id, fieldName.
• List List all Cloudbeds profile stats List Cloudbeds profile statistics for a given profile, optionally filtered by property. Returns: profileId, propertyId, reservations, nights, revenue, sources, lastVisit. Required: profile_id.
• List List all Cloudbeds profiles filters List available filter values for guest profiles in Cloudbeds. Returns: countries, guestStatuses, 5XX. Required: organization_id.
• List List all Cloudbeds profile sources List the sources of a Cloudbeds profile. Returns: name, date, 5XX. Required: profile_id.
• Create Create a Cloudbeds profile anonymize Anonymize a Cloudbeds guest profile, replacing personally identifiable fields with masked or placeholder values. Returns the anonymized profile including id, firstName, lastName, email, dateCreated, dateModified, dateAnonymized. Required: profile_id. GDPR anonymization must be enabled for the organization's properties.
• List List all Cloudbeds merges suggesteds List suggested guest profile merges in Cloudbeds. Returns: suggestions. Required: organization_id. Filterable by profileId.
• List List all Cloudbeds profile custom fields List custom fields for a specific Cloudbeds profile. Returns: id, customFieldId, name, value, label, type, isPersonal, order, maxLen, required. Required: profile_id.
• List List all Cloudbeds profile reservations List reservations for a specific Cloudbeds guest profile. Returns: id. Required: profile_id.
• List List all Cloudbeds profile merged profiles List profiles currently merged into a given Cloudbeds profile. Returns: profileId, mergeId, firstName, lastName, email, phone, isUnmergeEligible, mergedAt. Required: profile_id.
• List List all Cloudbeds merges List guest profile merges in Cloudbeds. Returns: id. Filterable by mergedAt using colon-separated filter syntax (e.g. mergedAt:greater_than_or_equal:2024-07-17T14:00:00-08:00).
• Create Create a Cloudbeds merge Merge guest profiles in Cloudbeds. Returns the created merge record including id, mergedAt, eventType, beforeMergeProfiles, and afterMergeProfiles. A JSON request body specifying the profiles to merge is required.
• Create Create a Cloudbeds merge unmerge Unmerge previously merged guest profiles in Cloudbeds by merge id. Returns the profile merge record including id, mergedAt, eventType, beforeMergeProfiles, and afterMergeProfiles with full guest profile details. Required: merge_id.
• List List all Cloudbeds v 1 1 charts List Cloudbeds charts across all data sources with optional filtering by chart kind, datasource kind, tags, and datasets. Returns: id, created_at, updated_at. Max 100 per page.
• Search Cloudbeds v 1 1 charts search Search Cloudbeds charts by text across title, datasource_title, and datasource_description fields, with all the same filters available on list. Returns: id, created_at, updated_at. Max 100 per page.
• List List all Cloudbeds v 1 1 datasets List all available Cloudbeds Data Insights datasets such as Financial, Guest, Reservations, Occupancy, Payments, Invoices, and Housekeeping. Returns: description.
• Get Get single Cloudbeds v 1 1 dataset by ID Get a single Cloudbeds Data Insights dataset by id, including its CDF (Cloudbeds Data Field) information and the last time the dataset was refreshed. CDFs may be grouped by category. Returns: description, updated_at. Required: id.
• List List all Cloudbeds dataset updated ats Get the last time a Cloudbeds property received a Data Insights event for a specific dataset. Returns: updated_at. Required: dataset_id.
• List List all Cloudbeds dataset multi levels List all multi-levels associated with a Cloudbeds dataset in the Data Insights API. Multi-levels are sub-groupings within a dataset (e.g., Room Reservation under Reservations) that organize associated CDFs. Some datasets may have no multi-levels. Returns: id. Required: dataset_id.
• Get Get single Cloudbeds dataset multi level by ID Get a single multi-level for a Cloudbeds dataset in the Data Insights API. The multi-level organizes associated CDFs (Cloudbeds Data Fields) within the dataset hierarchy. Returns: id. Required: dataset_id, id.
• List List all Cloudbeds v 1 1 folders List all report folders created under a Cloudbeds property. Returns: id, name, parent_id.
• Create Create a Cloudbeds v 1 1 folder Create a report folder for a Cloudbeds property. Returns: id, name, parent_id. Folder names must be unique and maximum nesting depth is 3 levels. Required: name.
• Get Get single Cloudbeds v 1 1 folder by ID Get a single Cloudbeds report folder by id. Returns: id, name, parent_id. Required: id.
• Update Update a Cloudbeds v 1 1 folder by ID Update a Cloudbeds report folder by id. Returns: id, name, parent_id. A folder cannot have itself as parent_id, names must be unique, and maximum nesting depth is 3 levels. Required: id, name.
• Delete Delete a Cloudbeds v 1 1 folder by ID Delete a Cloudbeds report folder by id. The folder must not have assigned reports or a parent_id. Returns an empty 204 response on success. Required: id.
• Create Create a Cloudbeds folder report Assign a report to a Cloudbeds Data Insights folder to organize reports. Returns the updated folder object including id and name. Required: folder_id, report_id.
• Delete Delete a Cloudbeds folder report by ID Remove a report assignment from a Cloudbeds Data Insights folder. Returns an empty 204 response on success. Required: id, report_id.
• List List all Cloudbeds v 1 1 healths Check the health of the Cloudbeds Data Insights service, which performs checks on infrastructure service connections, host storage, application-specific logic, and direct dependencies. Returns: status.
• List List all Cloudbeds v 1 1 hubs List all Cloudbeds data insights hubs. Returns: id, description, created_at, updated_at. Max 100 results per page.
• Create Create a Cloudbeds v 1 1 hub Create a new Cloudbeds data insights hub. Returns: id, description, created_at, updated_at.
• Get Get single Cloudbeds v 1 1 hub by ID Get a single Cloudbeds data insights hub by id. Returns: id, description, created_at, updated_at. Required: id.
• Update Update a Cloudbeds v 1 1 hub by ID Update a Cloudbeds data insights hub by id. Returns: id, description, created_at, updated_at. Required: id.
• Delete Delete a Cloudbeds v 1 1 hub by ID Delete a Cloudbeds data insights hub by id. Returns an empty 204 response on success. Required: id.
• Search Cloudbeds v 1 1 hubs search Search Cloudbeds Data Insights hubs by text term, title, description, or IDs. Returns hub records with id, title, description, created_at, and updated_at. Max 100 results per page.
• List List all Cloudbeds hub cards Get a Cloudbeds hub card by its card id within a hub. Returns the card object including its id, hub_id, chart_id, created_at, and updated_at. Required: hub_id, card_id.
• Update Update a Cloudbeds hub card by ID Update a Cloudbeds hub card by id. Returns the updated card object including its id, hub_id, chart_id, created_at, and updated_at. Required: hub_id, id.
• Delete Delete a Cloudbeds hub card by ID Delete a Cloudbeds hub card by id. Returns an empty 204 response on success. Required: hub_id, id.
• Create Create a Cloudbeds hub card Create a Cloudbeds hub card linking a hub to a chart. Returns the created card object including its id, hub_id, chart_id, created_at, and updated_at. Required: hub_id, chart_id.
• List List all Cloudbeds datainsights v 1 1 s Get profile data about the current Cloudbeds user from the Data Insights API. Returns: data.
• Search Cloudbeds datainsights v 1 1 s search Search across different Cloudbeds Data Insights resources (reports and stock reports). Returns: data (paginated search results grouped by requested resource; fields are defined by the upstream Search schema and are not enumerated in the discovered source). Required: filters, resources. Filters must be formatted as column:value (e.g. title:res); valid filter columns are title and description. Max…
• List List all Cloudbeds v 1 1 properties List Cloudbeds properties associated with the current user from the Data Insights API. Returns an array of property records, each containing an id and an attributes object with property-specific fields.
• List List all Cloudbeds v 1 1 policies List policy data about the current user in Cloudbeds. Returns policy objects whose fields are defined in the upstream MePolicy schema; consult the Cloudbeds OpenAPI specification for the field-level breakdown.
• List List all Cloudbeds v 1 1 reports List Cloudbeds Data Insights reports for a single property. Returns: id, description, updated_at. Max 100 per page.
• Create Create a Cloudbeds v 1 1 report Create a new Cloudbeds Data Insights report. Returns the created report including id, title, type, dataset_id, columns, settings, and updated_at. The report type (List, PeriodList, Summary, PeriodSummary, Pivot) determines which properties are included in the body.
• Get Get single Cloudbeds v 1 1 report by ID Get a single Cloudbeds Data Insights report by id. Returns: id, description, type, updated_at. Required: id.
• Update Update a Cloudbeds v 1 1 report by ID Update a single Cloudbeds Data Insights report by id. Returns the updated report including id, title, type, dataset_id, columns, settings, and updated_at. Required: id.
• Delete Delete a Cloudbeds v 1 1 report by ID Delete a Cloudbeds Data Insights report by id. Returns an empty 204 response on success. Required: id.
• Action Cloudbeds v 1 1 reports clone Clone a Cloudbeds Data Insights report from an existing one. Returns: id, description, updated_at. Required: report_id. A JSON request body is required.
• Search Cloudbeds v 1 1 reports search Search Cloudbeds Data Insights reports by title, description, dataset, folder, tag, or user filters. Returns: id, description, updated_at. Max 100 results per page. Title filtering is case-insensitive; returns 200 even with no results.
• List List all Cloudbeds data Get report data by report id from Cloudbeds Data Insights. The response structure varies by report type (List, Summary, Pivot, PeriodList, etc.). Returns: columns, headers, records, settings, index, group_rows, group_columns, periods. Required: report_id.
• List List all Cloudbeds report summaries Get a Cloudbeds report summary by report id. The response structure varies by report type (Summary, PeriodSummary, Pivot, etc.) and includes columns, records, settings, headers, and optionally group_rows, group_columns, periods, and index. Required: report_id.
• List List all Cloudbeds report exports Export a Cloudbeds report by report_id in the requested format (xlsx, csv, or json). Returns the report export object including columns, settings, group_rows, group_columns, and periods, with structure varying by report type. Required: report_id, view, format.
• List List all Cloudbeds report properties List report properties for a specific Cloudbeds Data Insights report. Returns an array of report property objects, each with id and attributes whose fields are defined by the ReportProperty schema upstream. Required: report_id.
• Create Create a Cloudbeds query datum Query report data in Cloudbeds without first creating a report. Returns: columns, settings, periods, group_rows, and group_columns, with the exact structure depending on the report type. Required: mode and a report query body. Preview mode returns up to 100 records; Run mode returns up to 12,000 records.
• Create Create a Cloudbeds query summary Query a Cloudbeds report summary from a report definition without persisting it. Returns: columns, settings, group_rows, group_columns, periods — the exact fields depend on the report type. Required: mode. A request body containing the report query definition must be supplied. Preview mode limits to 100 records; Run mode limits to 12,000 records.
• Create Create a Cloudbeds query export Export Cloudbeds report data to xlsx, csv, or json from an ad-hoc report definition that has not been saved as a created report. Returns: columns, settings, records, headers, and optionally group_rows, group_columns, and periods depending on report type. Required: view, format, and a report query body including type. Export mode supports up to 100000 records.
• List List all Cloudbeds report custom cdfs List all custom CDFs (Cloudbeds Data Fields) created on a Cloudbeds report. Returns each custom CDF with id, name, column, and formula. Required: report_id.
• Create Create a Cloudbeds report custom cdf Create a custom CDF on a Cloudbeds report based on existing CDFs. The column name is auto-generated from the name. Returns: id, name. Required: report_id, name, formula. The formula must be validated before creation.
• Update Update a Cloudbeds report custom cdf by ID Update an existing custom CDF on a Cloudbeds report. Returns: id, name. Required: report_id, id, name, formula.
• Delete Delete a Cloudbeds report custom cdf by ID Delete a custom CDF from a Cloudbeds report. Returns an empty 204 response on success. Required: report_id, id.
• Get Get single Cloudbeds report custom cdf by ID Get a single custom CDF created on a Cloudbeds report by id. Returns: id, name, column, formula. Required: report_id, id.
• Update Cloudbeds custom cdfs validates bulk update Validate a custom CDF formula for a Cloudbeds report before creation. Returns the validated formula as a list of objects, each containing kind and value. Required: report_id. Formula kind must be one of cdf, separator, operator, operand, or parenthesis.
• Delete Delete a Cloudbeds report tag by ID Delete the association between a Cloudbeds report and a tag by unassigning the tag from the report. Returns an empty 204 response on success. Required: report_id, id.
• List List all Cloudbeds report tags List all tags associated with a Cloudbeds report. Returns: id, tag_id, name. Required: report_id.
• Create Create a Cloudbeds report tag Associate an existing Cloudbeds tag with a report by providing the tag id. Returns: id, name, created_at. Required: report_id, tag_id.
• List List all Cloudbeds filters relative dates List possible relative date entries available for Cloudbeds report filters. Returns: value. Each value is either a standalone keyword (e.g. 'yesterday', 'years_prior') or a keyword with a duration separated by a semicolon (e.g. 'days_later;42', 'years_prior;1').
• List List all Cloudbeds reports limits Get the report usage limits for the current property from Cloudbeds Data Insights. Returns: attributes containing the ReportLimit object with report limit details.
• List List all Cloudbeds reports formats List available report format types in Cloudbeds. Returns an array of format option objects, each with an id and format-specific attributes. Only the 'date' format type is currently documented.
• Get Get single Cloudbeds reports format by ID Get format options for a specific report format type in Cloudbeds. Returns an array of format option objects with id and format-specific attributes; for the 'date' type these are date format strings using DD, MM, YYYY tokens with /, -, or . separators. Required: id (currently only 'date' is supported).
• List List all Cloudbeds report charts List all charts for a specific Cloudbeds report. Returns: id, created_at, updated_at. Required: report_id.
• Create Create a Cloudbeds report chart Create a new chart for a Cloudbeds report. Returns the created chart including its id, title, kind, datasource_kind, created_at, and updated_at. Required: report_id.
• Update Update a Cloudbeds report chart by ID Update an existing Cloudbeds report chart by id. Returns the updated chart including its id, title, kind, datasource_kind, created_at, and updated_at. Required: report_id, id.
• Delete Delete a Cloudbeds report chart by ID Delete a Cloudbeds report chart by id. Returns an empty 204 response on success. Required: report_id, id.
• Get Get single Cloudbeds report chart by ID Get a single Cloudbeds report chart by id. Returns the Chart object including its chart_id. Required: report_id, id.
• Create Create a Cloudbeds export async Queue an async export task for a Cloudbeds report by id. Returns: queueTaskId, queueTaskId_str, status. Required: report_id, view, format. The export runs asynchronously; poll the returned task id via the tasks endpoints to check completion status.
• List List all Cloudbeds property settings List all property settings for a specific Cloudbeds property. Returns: name. Setting names include start_of_week and currency_cdf_rounding_precision.
• Update Update a Cloudbeds property setting by ID Update a Cloudbeds property setting by id. Valid setting names: start_of_week, currency_cdf_rounding_precision. Returns: name. Required: id.
• Get Get single Cloudbeds property setting by ID Get a specific Cloudbeds property setting by id. Returns: name, value. The setting name identifies the configuration option (e.g. start_of_week, currency_cdf_rounding_precision). Required: id.
• List List all Cloudbeds v 1 1 schedules List Cloudbeds report workbook schedules with optional filtering by schedule ID, subject, cron frequency, and date match. Returns: id, created_at, updated_at. Max 100 results per page.
• Create Create a Cloudbeds v 1 1 schedule Create a schedule for a Cloudbeds report workbook. Returns the created schedule including id, subject, view, format, frequency, created_at, and updated_at.
• Get Get single Cloudbeds v 1 1 schedule by ID Get a single Cloudbeds schedule by id. Returns: id, created_at, updated_at. Required: id.
• Update Update a Cloudbeds v 1 1 schedule by ID Update a Cloudbeds schedule by id. Returns the updated schedule including id, subject, view, format, frequency, created_at, and updated_at. Required: id.
• Delete Delete a Cloudbeds v 1 1 schedule by ID Delete a Cloudbeds schedule by id. Returns an empty 204 response on success. Required: id.
• Create Create a Cloudbeds schedule run Trigger a run of a scheduled Cloudbeds report export by schedule_id, queuing an async export task. Returns a queue task response that includes a token for tracking the run status via the tasks/token endpoint. Required: schedule_id.
• List List all Cloudbeds v 1 1 stock reports List Cloudbeds stock reports with filtering and sorting. Returns each report with id, title, description, dataset_id, updated_at, and published. Max 100 per page. The include_cloudbeds and property_country_only parameters are mutually exclusive.
• Create Create a Cloudbeds v 1 1 stock report Publish a new stock report in Cloudbeds with optional rules. Returns the created report with id, title, description, dataset_id, type, updated_at, and published.
• Get Get single Cloudbeds v 1 1 stock report by ID Get a single Cloudbeds stock report by id. Stock reports are reports owned by Cloudbeds and cannot be edited, only copied. Returns: id, description, type, updated_at, created_at. Required: id.
• Update Update a Cloudbeds v 1 1 stock report by ID Update a Cloudbeds stock report by id. Returns the updated report with id, title, description, dataset_id, type, updated_at, and published. Required: id.
• Delete Delete a Cloudbeds v 1 1 stock report by ID Unpublish a Cloudbeds stock report by id. Returns an empty 204 response on success. Required: id.
• Search Cloudbeds v 1 1 stock reports search Search Cloudbeds stock reports by title, description, dataset, folder, published status, or free-text term. Returns: id, description, updated_at. The API returns 200 even when no results are found; title matching is case-insensitive. Max 100 results per page. The include_cloudbeds and property_country_only filters are mutually exclusive.
• Action Cloudbeds v 1 1 stock reports clone Clone a Cloudbeds stock report by id, creating a new report that copies the original's configuration and charts. Returns the created report including id, title, description, dataset_id, updated_at, and published. Required: stock_report_id and a JSON request body. Returns 201 on success; 404 if no report is found with the given id.
• Update Cloudbeds stock report rules bulk update Update the rules of a specific Cloudbeds stock report by stock_report_id. Returns the updated rules object including property_ids, feature_ids, country_codes, and property_types. Required: stock_report_id. The API returns 404 if no report is found with the given id.
• List List all Cloudbeds stock report data Get stock report data by id from Cloudbeds. Returns: columns, headers, records, index, group_rows, group_columns, periods, settings. The response structure varies by report type and may also include index, group_rows, group_columns, and periods. Required: stock_report_id, property_ids.
• List List all Cloudbeds stock report summaries Get a Cloudbeds stock report summary by id. Returns: columns, group_rows, and settings (including totals and transpose). Required: stock_report_id, property_ids.
• List List all Cloudbeds stock report exports Export a Cloudbeds stock report by id in xlsx, csv, or json format. Returns: columns, settings (totals, transpose), and optionally periods, group_rows, and group_columns depending on report type. Required: stock_report_id, format, property_ids, view.
• List List all Cloudbeds stock reports rules List supported rule keys available for Cloudbeds stock reports in the Data Insights API. Returns: rules (the SupportedRules object containing the available rule keys). No additional parameters required.
• List List all Cloudbeds rules property IDS List supported property ID rule keys for Cloudbeds stock reports. Returns: key.
• List List all Cloudbeds rules feature IDS List supported feature ID rule keys for Cloudbeds stock reports. Returns an array of FeatureIdRules objects with id and rule-specific attributes.
• List List all Cloudbeds rules country codes List supported country code rule keys for Cloudbeds stock reports. Returns an array of rule objects, each containing a key identifier for a supported country code.
• List List all Cloudbeds rules property types List supported property type rule keys for Cloudbeds stock reports. Returns an array of supported property type rule key objects. No caller-supplied parameters required; the property context is determined automatically.
• List List all Cloudbeds stock report revisions List revisions for a Cloudbeds stock report. Returns: id, created_at. Required: stock_report_id.
• Get Get single Cloudbeds stock report revision by ID Get a specific revision of a Cloudbeds stock report. Returns the revision object including its id, created_at, and updated_at. Required: stock_report_id, id.
• List List all Cloudbeds stock report custom cdfs List all custom cdfs (Cloudbeds Data Fields) created for a stock report in Cloudbeds. Returns: id, name. Required: stock_report_id.
• Create Create a Cloudbeds stock report custom cdf Create a custom cdf for a stock report in Cloudbeds. A custom cdf builds a new column from an existing cdf using a validated formula; the column name is derived from the provided name in lowercase alphanumeric form. Returns: id, name. Required: stock_report_id.
• Update Update a Cloudbeds stock report custom cdf by ID Update an existing custom cdf on a stock report in Cloudbeds. Returns: id, name. Required: stock_report_id, id.
• Delete Delete a Cloudbeds stock report custom cdf by ID Delete a custom cdf from a stock report in Cloudbeds. Returns an empty 204 response on success. Required: stock_report_id, id.
• Get Get single Cloudbeds stock report custom cdf by ID Get a single custom cdf of a stock report in Cloudbeds. Returns: id, name, formula. Required: stock_report_id, id.
• List List all Cloudbeds stock report charts List Cloudbeds stock report charts for a given stock report. Returns: id, title, kind, created_at, updated_at. Required: stock_report_id.
• Create Create a Cloudbeds stock report chart Create a new chart for a Cloudbeds stock report. Returns the created chart object including id, title, kind, created_at, updated_at. Required: stock_report_id.
• Update Update a Cloudbeds stock report chart by ID Update a Cloudbeds stock report chart by id. Returns the updated chart object including id, title, kind, created_at, updated_at. Required: stock_report_id, id.
• Delete Delete a Cloudbeds stock report chart by ID Delete a Cloudbeds stock report chart by id. Returns an empty 204 response on success. Required: stock_report_id, id.
• Get Get single Cloudbeds stock report chart by ID Get a single Cloudbeds stock report chart by id. Returns: id, title, kind, created_at, updated_at. Required: stock_report_id, id.
• List List all Cloudbeds stock reports folders List all stock report folders managed by Cloudbeds for a property. Returns: id, name. Max 100 results per page (default 25).
• Create Create a Cloudbeds stock reports folder Create a new stock report folder in Cloudbeds to organize stock reports. Returns: id, name. Required: name.
• Get Get single Cloudbeds stock reports folder by ID Get a single stock report folder by id in Cloudbeds. Returns: id, name. Required: id.
• Delete Delete a Cloudbeds stock reports folder by ID Delete a stock report folder by id. Returns an empty 204 response on success. Required: id.
• Delete Cloudbeds stock reports folders bulk delete Remove a stock report from a stock report folder. Returns an empty 204 response on success. Required: folder_id, stock_report_id.
• List List all Cloudbeds stock reports limits Get stock report generation limits in Cloudbeds. Returns the data object containing stock report generation limits and quotas as defined by the upstream Cloudbeds ReportLimit schema. No required parameters.
• List List all Cloudbeds v 1 1 tags List all tags created under a Cloudbeds property. Returns: id, name.
• Create Create a Cloudbeds v 1 1 tag Create a new tag for a Cloudbeds property to organize and label reports. Returns: id, name. Required: name. Tags cannot be duplicated and are case-sensitive (Financial and financial are distinct tags).
• Update Update a Cloudbeds v 1 1 tag by ID Update a Cloudbeds tag name by id; all reports using the tag will be updated with the new name. Returns: id, name. Required: id, name. Tags cannot be duplicated and are case-sensitive.
• Delete Delete a Cloudbeds v 1 1 tag by ID Delete a Cloudbeds tag by id. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds v 1 1 favorites List all Cloudbeds report favorites for the authorized user on a specific property. Returns: id.
• Create Create a Cloudbeds v 1 1 favorite Create a Cloudbeds report favorite for the authorized user. Returns: id. Required: rank, report_id. Maximum of 12 favorites per property; duplicate rank values shift existing favorites.
• Get Get single Cloudbeds v 1 1 favorite by ID Get a single Cloudbeds report favorite by id. Returns: id. Required: id.
• Update Update a Cloudbeds v 1 1 favorite by ID Update the rank of a Cloudbeds report favorite by id. Returns: id. Required: id, rank. If the new rank is already occupied, the positions are swapped.
• Delete Delete a Cloudbeds v 1 1 favorite by ID Delete a Cloudbeds report favorite by id. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds v 1 1 liveneses Get the liveness probe of the Cloudbeds Data Insights service to verify the service is alive. Returns an opaque liveness response; the Liveness schema fields are not enumerated in the available source documentation.
• List List all Cloudbeds v 1 1 explores Ask a natural language question about a Cloudbeds Data Insights dataset and receive an AI-generated exploration result. Returns an Explore object with data content whose shape depends on the question and dataset queried. Required: question, dataset_id.
• List List all Cloudbeds v 1 1 tasks List all Data Insights tasks for a single Cloudbeds property. Returns: id. Max 100 results per page.
• Get Get single Cloudbeds v 1 1 task by ID Get a Cloudbeds Data Insights task by id. Returns the queue task response object including its id and additional task attributes. Required: id.
• Get Get single Cloudbeds tasks token by ID Get the status of a queued Cloudbeds Data Insights task by its token. Returns the queue task response object. Required: id (the task token).
• List List all Cloudbeds discrepancies summaries Get the count of Cloudbeds fiscal documents that have discrepancies, filtered by a specific source. Returns: count. Required: sourceId, sourceKind.
• List List all Cloudbeds fiscal document fiscal documents List fiscal documents in Cloudbeds filtered by optional criteria. Returns: id, createdAt. Supports sorting by createdAt, dueDate, invoiceDate, kind, or status in ascending or descending order.
• Update Update a Cloudbeds fiscal document fiscal document by ID Update a Cloudbeds fiscal document's status, government integration details, or failure reason by id. Returns: id, createdAt. Required: id. CANCEL_REQUESTED for invoice cancellation is available for Spanish properties only; only OPEN, PAID, PARTIALLY_PAID, or CORRECTION_NEEDED invoices can be canceled.
• List List all Cloudbeds fiscal documents transactions List available transactions for fiscal documents in Cloudbeds, filtered by source and document kind. Returns: id, createdAt. Required: sourceId, sourceKind. forDocumentType is deprecated; use documentKind instead. Transactions already included in fiscal documents are excluded unless showInvoiced is true.
• List List all Cloudbeds allocations transactions List available transactions for allocations in Cloudbeds, filtered by source and optionally by folio, document, or status. Returns: id, status, createdAt, serviceDate, transactionDate, internalCode, sourceId. Required: sourceId, sourceKind. Max 100 results per page.
• List List all Cloudbeds fiscal documents allocations List payment allocation transactions in Cloudbeds, with optional filters by source IDs, source identifiers, source kind, or receipt IDs. Returns allocation records with id and content-specific allocation attributes.
• List List all Cloudbeds receipts allocations List active receipt allocations for a specific Cloudbeds invoice, grouped by transaction ID. Returns allocations grouped by transactionId, including receipt and status details, with only those from receipts with active statuses included. Required: invoice_id.
• List List all Cloudbeds allocations summaries Get a summary of payment allocations for fiscal documents in Cloudbeds, filtered by a specific source and optionally by folios or fiscal documents. Returns the AllocationsSummary response object. Required: sourceId, sourceKind.
• List List all Cloudbeds transactions summaries Get totals of selected available transactions for fiscal documents in Cloudbeds (deprecated — use the POST create method instead). Returns: data (computed transaction totals summary). Required: sourceId, sourceKind.
• Create Create a Cloudbeds transactions summary Get totals of selected available transactions for fiscal documents in Cloudbeds, with support for partial transaction amounts via transactionIdToAmount. Returns: data (computed transaction totals summary).
• List List all Cloudbeds fiscal document transactions List transactions for a specific Cloudbeds fiscal document. Returns: id, createdAt. Required: fiscal_document_id. Max 100 per page.
• List List all Cloudbeds fiscal document recipients List recipients associated to a Cloudbeds fiscal document. Returns a list of FiscalDocumentRecipient objects including id. Required: fiscal_document_id.
• List List all Cloudbeds fiscal document downloads Download a fiscal document file from Cloudbeds by its fiscal document id. Returns the fiscal document as a binary file (application/octet-stream) with a Content-Disposition header indicating whether the content should be displayed inline or as an attachment. Required: fiscal_document_id.
• Create Create a Cloudbeds fiscal document email Send a Cloudbeds fiscal document (invoice) to a customer by email, initiating the delivery process. Returns a generic success object (200 OK) whose fields are not documented in the spec. Required: fiscal_document_id.
• Update Cloudbeds fiscal document require attentions bulk update Update the requireAttention flag on a Cloudbeds fiscal document. Returns the updated fiscal document summary including id, documentKind, status, and requireAttention. Required: id.
• Create Create a Cloudbeds fiscal documents invoice Create a fiscal document of type invoice in Cloudbeds. Returns the created fiscal document summary including id, kind, status, createdAt, invoiceDate, and dueDate. A JSON request body conforming to the CreateInvoiceRequest schema is required; use the fiscal documents rules endpoint to determine property-specific required fields.
• Get Get single Cloudbeds invoice preview by ID Get a fiscal document preview of the type invoice in Cloudbeds. Returns the invoice preview as a binary PDF file download. A JSON request body is required.
• Create Create a Cloudbeds fiscal documents credit note Create a credit note fiscal document in Cloudbeds. Returns the created document summary including id, documentKind, and status. Requires a credit note request body (CreateCreditNoteRequest).
• Get Get single Cloudbeds credit note preview by ID Get a preview of a Cloudbeds fiscal document of type credit note. Returns a binary file download (application/octet-stream) with a Content-Disposition header indicating inline or attachment disposition. A JSON request body is required.
• Create Create a Cloudbeds fiscal documents rectify invoice Create a rectify invoice fiscal document in Cloudbeds. Only available for properties in Spain; the target invoice must not have been previously rectified, otherwise the API returns an error indicating which invoice in the rectification chain to rectify instead. Returns: id. A request body is required.
• Get Get single Cloudbeds rectify invoice preview by ID Get a fiscal document preview of the type rectify invoice in Cloudbeds. Returns a binary file (PDF) download. Only available for properties in Spain; the target invoice must not have been previously rectified. A JSON request body is required.
• Create Create a Cloudbeds fiscal document settlement Create a settlement invoice for an existing advance invoice in Cloudbeds, finalizing its billing cycle. Returns the created fiscal document summary including id, kind, status, and createdAt. Required: advance_invoice_id. The parent document must be an active ADVANCE_INVOICE with no existing active settlement.
• Get Get single Cloudbeds pro forma invoice preview by ID Generate a preview PDF of a pro forma invoice fiscal document in Cloudbeds. Returns a binary file download (application/octet-stream) with a Content-Disposition header. Required: a JSON request body following the ProFormaInvoicePreviewRequest schema. Pro forma invoices contain pending, unlocked transactions that can be converted to regular invoices later.
• Create Create a Cloudbeds fiscal documents pro forma invoice Create a pro forma invoice fiscal document in Cloudbeds. Contains pending (unlocked) transactions with payment information and its own sequence numbering; can be converted to a regular invoice when transactions are posted. Returns: id, documentKind, status. Required: a JSON request body.
• Update Cloudbeds pro forma invoice status bulk update Update the status of a pro forma invoice in Cloudbeds. Returns the updated fiscal document summary including id, documentKind, status, and createdAt. Required: id, status. Supported transitions: OPEN→ACCEPTED, REJECTED, CANCELED; ACCEPTED→CANCELED; REJECTED→CANCELED.
• Create Create a Cloudbeds fiscal documents receipt Create a receipt for a payment in Cloudbeds, optionally specifying allocations per transaction. Without allocations a 'Simple receipt' is created that can later be allocated to charge transactions. Returns the created fiscal document summary including its id, documentKind, and status. Allocation amounts must equal the payment amount and transactions must not be fully allocated already.
• Create Create a Cloudbeds fiscal documents simple receipt Create simple receipts in Cloudbeds for a list of payments without allocations. Returns an array of fiscal document summary objects including id, documentKind, and status for each created receipt. Required: request body specifying the payments to receipt.
• Create Create a Cloudbeds receipt void Void a Cloudbeds receipt by updating its status to VOIDED. Returns an empty 204 response on success. Required: receipt_id. The receipt must be in OPEN status; for Italy, a refund receipt is automatically created and linked to the voided receipt.
• Create Create a Cloudbeds receipt apply Apply a receipt to an invoice in Cloudbeds. The receipt must not have existing allocations. Returns an empty 204 response on success. Required: receipt_id.
• Create Create a Cloudbeds receipt allocate payment Allocate a receipt's payment to charge transactions in Cloudbeds. Returns the fiscal document summary including id, documentKind, status, and createdAt. Allocation amounts must sum to the payment amount and cannot exceed each transaction's remaining balance; transactions not on an invoice are added to a new invoice. Required: receiptId, allocations.
• List List all Cloudbeds fiscal document configs List fiscal document configs for a Cloudbeds property. Returns: data (fiscal document configuration objects with fields defined by the upstream OpenAPI schema).
• Update Cloudbeds fiscal document configs bulk update Update a fiscal document config for a specific document kind in Cloudbeds. Returns: data (the updated fiscal document configuration object with fields defined by the upstream OpenAPI schema). Required: document_kind.
• List List all Cloudbeds configs logos Get the logo image used in fiscal document templates in Cloudbeds, returned as a presigned URL. Returns: logoUrl.
• Create Create a Cloudbeds configs logo Upload a logo image file for fiscal document templates in Cloudbeds. Returns an empty 204 response on success. Required: file.
• Update Cloudbeds configs logos bulk update Crop a previously uploaded logo for fiscal document templates in Cloudbeds. The original image is preserved; output is stored as PNG and resized to at most 1000 px on the longest dimension. Returns a 200 response with no body on success. Required: x, y, width, height.
• Delete Cloudbeds configs logos bulk delete Delete the logo image used in fiscal document templates in Cloudbeds. Returns an empty 204 response on success.
• List List all Cloudbeds configs previews Get a PDF document preview from Cloudbeds. Builds and returns the rendered PDF document as a binary file download (application/octet-stream). The response includes a Content-Disposition header indicating whether the file should be displayed inline or as an attachment.
• List List all Cloudbeds fiscalization registrations Get the fiscalization registration (supplier/party info) for a Cloudbeds property. Returns: id, attributes, created_at, updated_at. The attributes object contains country-specific fields as defined by the property's fiscalization regime.
• Create Create a Cloudbeds fiscalization registration Create a new fiscalization registration (supplier/party info) for a Cloudbeds property. Returns: id, attributes, created_at, updated_at. Required: attributes. The attributes object must contain country-specific fields as defined by the fiscalization regime's rules.
• Update Cloudbeds fiscalization registrations bulk update Update the fiscalization registration (supplier/party info) for a Cloudbeds property. Returns: id, attributes, created_at, updated_at. Required: attributes. The attributes object must contain country-specific fields as defined by the fiscalization regime's rules.
• List List all Cloudbeds property features Get enabled feature flags for the current user and property in Cloudbeds. Returns a map of feature flag names to boolean values, e.g. INTEGRATION_INVOICING. The property context is supplied via the X-PROPERTY-ID header which Truto manages automatically.
• List List all Cloudbeds fiscal documents rules Get Cloudbeds fiscal document creation rules (field definitions) for a given document kind, describing the fields the UI must collect when creating a document of that kind. Returns: attributes (FieldDefinition properties for each field). Required: documentKind.
• Create Create a Cloudbeds folios export Export a folio's list of transactions as a PDF file in Cloudbeds. Returns a binary PDF file download. Required: request body specifying the folio export criteria.
• Get Get single Cloudbeds folio export PDF by ID Get a folio list of transactions exported as a PDF file in Cloudbeds. Returns a binary PDF file download (application/octet-stream) with a Content-Disposition header. Requires a JSON request body specifying the folio export criteria.
• List List all Cloudbeds registration rules Get country-specific fiscalization registration rules for building forms in Cloudbeds. Returns: sections (the full section list) and fields (field definitions filtered by sectionKey, defaulting to registration). Required: country.
• Create Create a Cloudbeds registration validate Validate fiscalization registration party data in Cloudbeds against country-specific fiscalization rules based on the regime field. Returns: valid.
• List List all Cloudbeds registration countries List countries available for fiscalization property registration in Cloudbeds, based on the property's location. Returns: name.
• List List all Cloudbeds registration status List fiscalization registration status for a Cloudbeds property. Returns: country, status — the registration status with government systems for each configured country.
• List List all Cloudbeds fiscalization providers Get fiscalization provider info for a country in Cloudbeds, identifying which provider handles fiscal registration for the given country. Returns the provider info object with schema-specific fields from the upstream FiscalizationProviderInfo schema. Required: country. A 400 error is returned when no provider is configured for the specified country.
• List List all Cloudbeds fiscalization consents Get the fiscalization consent status for a Cloudbeds property. Returns the consent status object indicating whether the property has consented to fiscalization. Returns 404 when no consent has been recorded for the property.
• Create Create a Cloudbeds fiscalization consent Record user consent for fiscalization in Cloudbeds, confirming the user has consented to sharing data with the fiscalization provider. Returns the consent status object upon successful recording. The request body is required.
• Get Get single Cloudbeds fiscalization report by ID Download a country-specific fiscalization report from Cloudbeds (e.g., SAF-T for Portugal). Returns a binary XML file with the download filename specified in the Content-Disposition header. Required: id (report identifier, e.g. "saft"), year. Period defaults to 0 (full year); use 1–12 for monthly reports.
• List List all Cloudbeds tax rules List Cloudbeds fiscalization tax rules for a country. Returns: attributes containing country-specific tax categories and rates for configuring tax mappings. Required: country.
• List List all Cloudbeds fiscalization taxes Get the fiscalization tax configuration for a Cloudbeds property. Returns the tax configuration object with fields defined by the upstream FiscalizationTaxResponse schema in the Cloudbeds Fiscal Document API OpenAPI specification.
• Update Cloudbeds fiscalization taxes bulk update Create or update the fiscalization tax configuration for a Cloudbeds property. Returns the saved tax configuration object with fields defined by the upstream FiscalizationTaxResponse schema in the Cloudbeds Fiscal Document API OpenAPI specification. Required: a JSON request body with the tax configuration fields.
• List List all Cloudbeds payment methods rules List country-specific fiscalization payment method rules from Cloudbeds. Returns the available GOBL payment means keys used for configuring payment method mappings. Required: country (ISO 3166-1 alpha-2 code, e.g. PT, IT, MX).
• List List all Cloudbeds fiscalization payment methods Get the fiscalization payment method mapping configuration for a Cloudbeds property. Returns: attributes containing the property's payment method mapping configuration.
• Update Cloudbeds fiscalization payment methods bulk update Create or update the fiscalization payment method mapping configuration for a Cloudbeds property by submitting the mapping configuration in the request body. Returns: attributes containing the saved payment method mapping configuration.
• List List all Cloudbeds operators rules Get fiscal operator rules for a country from Cloudbeds. Returns country-specific rules for the fiscal operator mapping (e.g. tax-ID format, checksum, label), including operatorRequired which indicates whether operator-level fiscalization is needed. Required: country.
• List List all Cloudbeds fiscalization operators List Cloudbeds property users with their fiscal operator OIB mapping. Users without a configured mapping appear with oib set to null. Returns: oib.
• Update Cloudbeds fiscalization operators bulk update Replace all fiscal operator OIB mappings for a Cloudbeds property. Each entry must reference a user assigned to the property and carry a syntactically valid OIB. Returns: userId, oib. Required: userId and oib in each operator entry.
• List List all Cloudbeds fiscalization customizations Get the fiscalization customization configuration for a Cloudbeds property. Returns: logo, locale, layout.
• Update Cloudbeds fiscalization customizations bulk update Create or update the fiscalization customization configuration for a Cloudbeds property. Returns the updated configuration including logo, locale, and layout.
• List List all Cloudbeds customization logos Get the fiscalization customization logo in Cloudbeds, returning a presigned URL for the logo image. Returns: url.
• Create Create a Cloudbeds customization logo Upload a logo image for the fiscalization customization in Cloudbeds. Returns an empty response on success. Required: file.
• Delete Cloudbeds customization logos bulk delete Delete the fiscalization customization logo in Cloudbeds. Returns an empty response on success.
• Get Get single Cloudbeds fiscalization section by ID Get the current fiscalization section values for a Cloudbeds property by section key. Returns a values object containing section-specific configuration projected from GOBL Party extensions; the exact keys depend on the country's fiscalization rules for the requested section (e.g. customization.invoicing). Required: id.
• Update Update a Cloudbeds fiscalization section by ID Update fiscalization section values for a Cloudbeds property via a partial merge update. Returns the updated section with its values. Required: id (sectionKey). Only keys tagged with this section in the country rules are accepted; sections marked immutableAfterRegistration cannot be edited once the property is registered, and this call does not re-sync with the fiscalization provider.
• List List all Cloudbeds items rules Get country-specific item extension mapping rules for fiscalization in Cloudbeds. Returns: categories (country-specific item categories) and extensions (GOBL extension fields for per-item mapping). Required: country.
• List List all Cloudbeds fiscalization items Get the per-item GOBL extension mapping configuration for a Cloudbeds property. Returns the item extension mapping configuration object with GOBL extension mapping fields defined by the upstream ItemMappingResponse schema.
• Update Cloudbeds fiscalization items bulk update Create or update the per-item GOBL extension mapping configuration for a Cloudbeds property. Returns the saved item extension mapping configuration object with fields defined by the upstream ItemMappingResponse schema. Requires a JSON request body containing the mapping configuration as defined by the upstream ItemMappingRequest schema.
• List List all Cloudbeds fiscalization credentials Get fiscalization credentials status for a property in Cloudbeds. Returns metadata about the stored fiscalization provider credentials including username (password is never returned). Returns 404 if credentials have never been set or if the country does not require credentials.
• Update Cloudbeds fiscalization credentials bulk update Set or update text-based fiscalization credentials (username and password) for a property's supplier in Cloudbeds. Used for countries that require portal login credentials (e.g., PT AT portal). Returns an empty 204 response on success. Required: username, password.
• List List all Cloudbeds credentials certificates Get fiscalization certificate status for a property in Cloudbeds. Returns: attributes containing certificate metadata with timestamps and verification state. Returns 404 if no certificate has been uploaded or if the country does not require a certificate.
• Create Create a Cloudbeds credentials certificate Upload a fiscalization certificate file for a property in Cloudbeds. Returns an empty 204 response on success. Required: file. privateKey is additionally required for PL KSeF and MX e.firma.
• List List all Cloudbeds series rules List available fiscalization series rules for a country in Cloudbeds. Returns: data containing the available document type prefixes and series types used to build the series registration UI. Required: country.
• List List all Cloudbeds fiscalization series Get the fiscalization series configuration for a Cloudbeds property. Returns: entries — the document kind to series name mappings for the property (each entry includes documentKind and seriesName).
• Update Cloudbeds fiscalization series bulk update Create or update the fiscalization series configuration for a Cloudbeds property, mapping each document kind to a registered series name. Returns: the saved series configuration with documentKind and seriesName mappings for each entry. Required: series.
• Update Cloudbeds series activates bulk update Activate a fiscalization series for a Cloudbeds property, which also deactivates other series of the same document kind. Returns the property's updated series configuration with document kind to series name mappings. A JSON request body identifying the series to activate is required.
• Update Cloudbeds series deactivates bulk update Deactivate a fiscalization series for a Cloudbeds property by document kind. Returns the updated series configuration including documentKind, seriesName, and isActive. Required: property_id, documentKind.
• List List all Cloudbeds catalogue countries List supported countries available for Cloudbeds fiscalization. Returns: code, name. No required parameters.
• List List all Cloudbeds countrie channels List fiscal channels available for a specific country in Cloudbeds. Returns the available fiscal channels for the given country, each identified by a channel_code. Required: country_code.
• List List all Cloudbeds channel providers List fiscalization providers available for a given country and channel in Cloudbeds. Returns the list of providers available for the specified country and channel. Required: country_code, channel_code.
• List List all Cloudbeds fiscalization status Check whether a Cloudbeds property is ready to issue fiscal documents. Returns the fiscalization status response object whose attributes contain provider-specific readiness fields defined in the upstream FiscalizationStatusResponse schema.
• List List all Cloudbeds fiscalization connections List fiscalization connections for a property in Cloudbeds. Returns each connection with its id, status, and providerId. The optional drafts parameter controls whether draft connections are included.
• Create Create a Cloudbeds fiscalization connection Create a fiscalization connection in Cloudbeds. Returns the created connection with id, status, and providerId. Required: providerId. Returns 409 if the provider is already connected for the property.
• Get Get single Cloudbeds fiscalization connection by ID Get a single fiscalization connection by id in Cloudbeds. Returns: id. Required: id.
• Update Update a Cloudbeds fiscalization connection by ID Update a fiscalization connection by id in Cloudbeds. Returns the updated connection with id, status, and providerId. Required: id.
• Delete Delete a Cloudbeds fiscalization connection by ID Disconnect a fiscalization connection by id in Cloudbeds. Returns an empty 204 response on success. Required: id.
• Activate Cloudbeds fiscalization connections activate Activate a verifying fiscalization connection in Cloudbeds. Returns the updated FiscalConnection object including its id and provider-specific attributes. Required: connection_id.
• Pause Cloudbeds fiscalization connections pause Pause an active fiscalization connection in Cloudbeds. Returns the updated FiscalConnection object including its id and provider-specific attributes. Required: connection_id.
• Resume Cloudbeds fiscalization connections resume Resume a paused fiscalization connection in Cloudbeds. Returns the updated connection object including its id, status, and updated_at. Required: connection_id.
• Create Create a Cloudbeds connection test Test a Cloudbeds fiscalization connection to the tax authority. Returns the connection test result. Required: connection_id.
• List List all Cloudbeds options List available provider-specific options for a Cloudbeds fiscalization onboarding step (e.g., available accounts for registration, available series for the series step). Returns option objects with id and provider-specific attributes whose fields vary by step key. Required: connection_id, step_key.
• Create Create a Cloudbeds connection onboarding Submit data for an onboarding step of a Cloudbeds fiscalization connection. The request body shape varies by step and provider. Returns the updated FiscalConnection object including its connectionId. Required: connection_id, step_key.
• Create Create a Cloudbeds onboarding complete Complete onboarding and activate a fiscalization connection in Cloudbeds. Returns the activated FiscalConnection object including its id. Required: connection_id.
• List List all Cloudbeds connections drafts List in-progress fiscalization connection drafts for a property in Cloudbeds. Returns each draft's id and attributes containing registration data.
• Update Update a Cloudbeds connections draft by ID Upsert a fiscalization connection registration draft in Cloudbeds by id (providerId). Accepts a JSON request body with registration draft data and returns the upserted draft including its id and attributes. Required: id.
• Delete Delete a Cloudbeds connections draft by ID Discard a fiscalization connection registration draft in Cloudbeds by id (providerId). Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds fiscalization routings List all fiscalization routing rules for a Cloudbeds property. Returns each routing rule identified by country_code, channel_code, and flow_id.
• Update Cloudbeds fiscalization routings partial update Update a single fiscalization routing rule in Cloudbeds identified by country code, channel code, and flow id. Returns the updated rule with country_code, channel_code, and flow_id. Required: country_code, channel_code, id.
• Update Cloudbeds fiscalization routings bulk update Bulk-replace all fiscalization routing rules for a Cloudbeds property by submitting the full set of rules. Returns the updated routing rules with country_code, channel_code, and flow_id. Required: body.
• Create Create a Cloudbeds health check Verify proper operation of the Cloudbeds integration before configuration requests. Called prior to SetupProperty or other configuration calls to confirm connectivity. Returns: success, errors. Required: verb, guid, mya_property_id, ota_property_id, ota_property_password, ota_property_sub_id, shared_secret, ota_cid.
• Create Create a Cloudbeds setup property Verify and validate OTA property credentials in Cloudbeds by checking ota_property_id and ota_property_password. Returns: success, errors. Error 1001 indicates invalid credentials; 1002 indicates channel management is not yet enabled on the OTA side. Required: verb, mya_property_id, ota_property_id, guid, ota_cid.
• Update Update a Cloudbeds ari update by ID Send availability, rates, and restrictions (ARI) updates to an OTA connected through Cloudbeds. Returns: success, errors. Required: verb, currency, Inventory. Cloudbeds only supports availability on the room level; restrictions and rates are sent on the rate plan level.
• List List all Cloudbeds get booking lists Retrieve new or modified Cloudbeds bookings since a last-known UTC timestamp. Returns: booking_id, version for each booking record. Required: verb, ota_booking_version, ota_property_id, ota_property_password, ota_property_sub_id, mya_property_id, guid.
• Get Get single Cloudbeds get booking ID by ID Retrieve a detailed Cloudbeds booking by its OTA booking ID. Returns: success, Booking. Required: verb, booking_id.
• Create Create a Cloudbeds ack booking Acknowledge a booking on an OTA from the Cloudbeds side so Cloudbeds can confirm receipt. Returns: success, errors (with id and msg). Required: verb, booking_id, ota_property_id, ota_property_password, ota_property_sub_id, mya_property_id, guid, ota_cid, shared_secret. This capability is not enabled by default — contact Cloudbeds to enable it for your channel.
• Create Create a Cloudbeds cancel booking Cancel a booking on an OTA from the Cloudbeds side. Returns: success, errors. Required: verb, booking_id. This capability is not enabled by default — contact Cloudbeds to enable it for your channel.
• Create Create a Cloudbeds create property Create a new property with rooms, rate plans, taxes, and images on an OTA from Cloudbeds channel manager data. Returns: success, ota_property_id, ota_property_password, ota_property_sub_id, instruction_text, instruction_link, room_mappings. Required: mya_property_id, guid, ota_cid, verb, Property. Must be explicitly activated by Cloudbeds before use; rate plans only transmitted for new…
• Update Update a Cloudbeds update property by ID Update general property data in Cloudbeds after changes on the channel manager. Returns: success, errors. Required: mya_property_id, guid, verb, Property. Must be explicitly activated by Cloudbeds; many fields are optional and may not always be populated.
• Get Get single Cloudbeds get sub property by ID Get all OTA sub-properties associated with an OTA's username/password in Cloudbeds, enabling mapping of OTA property identifiers to Cloudbeds property IDs. Returns: success, SubProperties. Required: verb. This feature is not enabled by default; contact Cloudbeds to enable it for your OTA.
• Delete Delete a Cloudbeds delete room by ID Delete a room from a Cloudbeds property by specifying the room's Cloudbeds channel manager ID. Returns: success, errors. Required: verb, room.mya_room_id.
• Update Update a Cloudbeds update room by ID Create or update a room on the Cloudbeds channel manager after a room change. Returns: success, room_mappings. Required: verb, room.
• Update Update a Cloudbeds update tax by ID Synchronize taxes and fees in Cloudbeds after changes on the channel manager. Supports creating, updating, and deleting tax/fee entries with conditions, tiered amounts, and tax-basis-includes-fees configuration. Returns: success, errors. Required: verb, taxes.
• Delete Delete a Cloudbeds delete rate plan by ID Delete a rate plan from the Cloudbeds channel manager after it has been deleted on Cloudbeds. Returns: success. Required: verb, rateplan.mya_rate_id.
• Update Update a Cloudbeds update rate plan by ID Create or update a rate plan in Cloudbeds after it has been changed on the channel manager. Returns: success and room_mappings (containing mya_room_id, ota_room_id, ota_rate_id). Required: verb and rateplan.
• Create Create a Cloudbeds ari full refresh Enqueue a full ARI (availability, rates, and inventory) refresh for a property in Cloudbeds. Returns: Success, UpdateId, ErrorCode, Error. Required: ota, shared_secret. Full refreshes are heavy operations — only call when absolutely necessary, never on a scheduled basis.
• Create Create a Cloudbeds check availability Check if a room (rateplan) is available for booking on Cloudbeds before creating a reservation, helping prevent overbookings due to delayed or incorrect availability sync. Returns: Success, is_available, reasons_unavailable, ErrorCode, Error. Required: ota, ota_property_id, ota_room_id, ota_rateplan_id, start_date, end_date, unit_type, number_of_units.
• Create Create a Cloudbeds booking create Create a new booking in Cloudbeds by sending a booking creation callback to the channel manager, ensuring no delay between booking creation and import. Returns: Success, ErrorCode, Error. Required: ota, shared_secret, booking_json. The booking_json must be a JSON-encoded string following the Cloudbeds booking format.
• Create Create a Cloudbeds notify booking Notify Cloudbeds about a new or changed OTA booking so Cloudbeds immediately requests a GetBookingList call for the property and booking_id. Returns: Success, ErrorCode, Error. Pass ota_property_id (or ota_property_sub_id for multi-property OTAs) and booking_id in the request body. If BookingCreate has been implemented, NotifyBooking is not required.
• Create Create a Cloudbeds room info Retrieve rooms configured on a Cloudbeds property via the OTA callback. Returns: Success, RoomInfo. Required: mya_property_id, shared_secret.
• Create Create a Cloudbeds create group Create a new group profile in Cloudbeds with group name, status, notes, legal name, address, and contacts. Returns: success, errors. Required: verb, group_data. This call must be explicitly activated by Cloudbeds support before use.
• Update Update a Cloudbeds update group by ID Update a group profile on your OTA with the latest group details from Cloudbeds including group name, address, notes, status, and contacts. Returns: success, errors. Required: verb, group_data. This call must be explicitly activated by Cloudbeds before use.
• Delete Delete a Cloudbeds delete group by ID Delete a group profile in Cloudbeds that was previously created by a CreateGroup call. Returns: success, errors. Required: verb, group_code. This call must be explicitly activated by Cloudbeds support before it can be used.
• Create Create a Cloudbeds create group block Create a new group inventory block in Cloudbeds with block code, status, group details, ARI inventory/rates, notes, and auto-release schedule. Returns: success, errors. Required: verb, group_block_data. This call must be explicitly activated by Cloudbeds before use.
• Update Update a Cloudbeds update group block by ID Update a Cloudbeds group inventory block on your OTA with the latest block details — name, status, inventory, rates, restrictions, notes, and release schedule. Returns: success, errors. Required: verb, group_block_data. This call must be explicitly activated by Cloudbeds before it can be used.
• Delete Delete a Cloudbeds delete group block by ID Delete an inventory block in Cloudbeds previously created via CreateGroupBlock. Returns: success, errors. Required: verb, group_block_code. This endpoint must be explicitly activated by Cloudbeds support before it can be used.
• List List all Cloudbeds channel lists List all channels known to Cloudbeds with their names and corresponding IDs. Returns: success, channels. Required: verb, guid, ota_cid, shared_secret.
• Create Create a Cloudbeds pay by link Create a Pay By Link in Cloudbeds. Returns the created pay by link object including its uuid. The request body schema is defined by the PblCreateRequest component in the Cloudbeds OpenAPI specification; consult the upstream spec for the full field-level breakdown.
• Get Get single Cloudbeds pay by link by ID Retrieve a Pay By Link from Cloudbeds by id. Returns the pay by link object including its uuid. Required: id.
• List List all Cloudbeds keys List Cloudbeds Payment Element API keys, optionally filtered by property or revocation status. Returns: identity, property_ids, revoked. The secret field is never included in list responses. Max 100 per page.
• Create Create a Cloudbeds key Issue a new Cloudbeds Payment Element API key scoped to one or more properties. Returns: identity, secret, property_ids. The secret is only returned once at creation time and cannot be retrieved later. Required: property_ids.
• Delete Cloudbeds keys bulk delete Permanently revoke a Cloudbeds Payment Element API key by its identity. This action is irreversible. Returns: identity, revoked. Required: identity.
• Create Create a Cloudbeds tokens card Tokenize a card in Cloudbeds by submitting card data along with optional billing details; the tokenized payment method is securely stored for future transactions. Returns the tokenized card response object. Required: a JSON request body with card data (specific fields documented in the upstream TokenizeCardRequest schema).
• List List all Cloudbeds addons List property add-ons in Cloudbeds with basic information for a specific property. Returns: id, created_at, updated_at. Max 500 per page.
• List List all Cloudbeds catalogs amenities List all amenities in the Cloudbeds amenity catalog filtered by scope (property or room), each with its code, translated name, and category code. Returns: name. Required: scope.
• List List all Cloudbeds catalogs categories List Cloudbeds amenity categories for a specified scope (property or room), each with its code and translated name. Returns: name. Required: scope.
• List List all Cloudbeds propertie amenities List the complete set of active property amenities in Cloudbeds. Returns the active amenity codes for the property. Required: property_id.
• Update Cloudbeds propertie amenities bulk update Replace the complete set of active property amenities in Cloudbeds in a single atomic transaction. Returns the updated active amenity codes. Required: property_id.
• List List all Cloudbeds propertie room amenities List active room amenities for all rooms in a Cloudbeds property. Returns: id. Required: property_id.
• Update Cloudbeds propertie room amenities bulk update Replace the complete set of active amenities for multiple rooms in a Cloudbeds property in a single atomic transaction. Returns the room amenities update result. Required: property_id and a request body listing rooms with their amenity codes.
• List List all Cloudbeds room amenities List active room amenities for a specific room type in Cloudbeds. Returns: data, an array of amenity codes currently active for the room type. Required: property_id, room_type_id.
• Update Cloudbeds room amenities bulk update Replace the complete set of active room amenities for a room type in Cloudbeds in a single atomic transaction. Returns: data, an array of amenity codes set for the room type. Required: property_id, room_type_id. The request body is a bare JSON array of amenity codes.
• List List all Cloudbeds integration connected applications List connected API clients (applications) for a Cloudbeds property, optionally filtered by OAuth scopes. Returns: clientId, scopes.
• Create Create a Cloudbeds folio check Post a completed POS check (e.g., F&B) to a guest folio, house account, or group profile in Cloudbeds. Items are recorded as regular folio items tagged as POS-originated, not Custom Items. Returns: checkId, checkNumber, notice.
• Delete Delete a Cloudbeds folio check by ID Void a posted Cloudbeds check by id, reversing its ledger entries, payments, and linked gratuities end-to-end. Returns an empty 204 response on success. Idempotent — voiding an already-voided check also returns 204. Required: id.
• Get Get single Cloudbeds doorlock key by ID List Cloudbeds doorlock keys for a specific property, optionally filtered by reservation, sub-reservation, or key IDs. Returns: keyId, propertyId, reservationId, startDateTime, endDateTime, keyType, rooms. Required: id.
• Create Create a Cloudbeds doorlock key Create a new Cloudbeds doorlock key. Returns the created key including keyId, propertyId, reservationId, subReservationId, issuerId, startDateTime, endDateTime, encoder, keyType, code, rooms, commonRooms, externalId, mobileId, and guestId.
• Delete Cloudbeds doorlock keys bulk delete Delete multiple Cloudbeds doorlock keys at once by specifying a comma-separated list of key IDs. Returns an empty 204 response on success. Required: keyIds.
• Update Update a Cloudbeds doorlock key by ID Update a Cloudbeds doorlock key by id. Returns the updated key including keyId, propertyId, reservationId, startDateTime, endDateTime, keyType, and rooms. Required: id.
• Delete Delete a Cloudbeds doorlock key by ID Delete a Cloudbeds doorlock key by id. Returns an empty 204 response on success. Required: id.
• Get Get single Cloudbeds doorlock setting by ID Get doorlock settings for a specific property and application client in Cloudbeds. Returns the doorlock settings object including its id. Required: id.
• Update Update a Cloudbeds doorlock setting by ID Upsert doorlock settings for a specific property and application client in Cloudbeds. Returns an empty 201 response on success. Required: id.
• Delete Delete a Cloudbeds doorlock setting by ID Delete doorlock settings for a specific property and application client in Cloudbeds. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds events List events for a property in Cloudbeds. Returns events with id, eventCode, profileId, status, startDate, endDate, and createdAt. Filter by eventCode, profileId, status, and date ranges. Max 100 per page.
• Create Create a Cloudbeds event Create a new event in Cloudbeds, optionally associated with an existing group profile. Returns the created event including id, eventCode, profileId, status, startDate, endDate, and createdAt.
• Get Get single Cloudbeds event by ID Get a single Cloudbeds event by id. Returns event details including id, eventCode, profileId, status, startDate, endDate, and createdAt. Required: id.
• Update Update a Cloudbeds event by ID Update an existing Cloudbeds event by id. Only provided fields are updated; for profileId, omit to keep, null to clear, or provide a string to replace. Returns the updated event including id, eventCode, profileId, status, startDate, endDate, and createdAt. Required: id.
• Delete Delete a Cloudbeds event by ID Delete a Cloudbeds event by id. This is a soft delete. Returns an empty 204 response on success. Required: id.
• List List all Cloudbeds event notes List notes for a Cloudbeds event. Returns: id, content, createdAt, updatedAt. Required: event_id. Set includeArchived to true to include archived notes.
• Create Create a Cloudbeds event note Create a new note for a Cloudbeds event. Returns: id, content, createdAt, updatedAt. Required: event_id, content.
• Update Update a Cloudbeds event note by ID Update an existing note for a Cloudbeds event or archive it. Returns: id, content, createdAt, updatedAt. Required: event_id, id.
• Create Create a Cloudbeds folio gratuity Post one or more guest tips to a folio, house account, or group profile in Cloudbeds. Returns: gratuityId, notice. The request body must specify a folio target and one or more gratuity entries; each entry may include a partner-supplied gratuityId, taxId, and recipient userId.
• Delete Delete a Cloudbeds folio gratuity by ID Void a posted gratuity by its gratuityId in Cloudbeds. Returns an empty 204 response on success. Required: id.
• Create Create a Cloudbeds check gratuity Post one or more guest tips to an existing Cloudbeds check by check_id. The gratuity entries inherit the check's folio target and checkNumber; POS context stays on the linked check. Returns: gratuityId, notice. Required: check_id. Requires an Idempotency-Key header for request deduplication.
• Get Get single Cloudbeds housekeeping inspection by ID List housekeeping inspections for a Cloudbeds property. Returns: id. Required: id, propertyId.
• List List all Cloudbeds integration events List Cloudbeds integration event subscriptions for a specific property. Returns: id. Max 500 per page.
• Create Create a Cloudbeds integration event Create a new Cloudbeds integration event subscription. Returns: id. Required: event, subscriptionData.
• Update Update a Cloudbeds integration event by ID Update an existing integration event subscription in Cloudbeds by id. Returns the updated integration event including its id, key, event, subscriptionType, and subscriptionData. Required: id.
• Create Create a Cloudbeds event retry Retry a Cloudbeds integration event by event_id, sending a request to re-process the event. Returns: message. Required: event_id.
• List List all Cloudbeds item custom items List custom items for a specific Cloudbeds property. Returns a paginated list of custom item records with their id, name, and pricing details. Supports optional dynamic filters formatted as semicolon-separated field:value pairs. Max 500 items per page.
• Create Create a Cloudbeds item Post one or more items to a reservation, house account, or group profile in Cloudbeds. Supports batch operations allowing multiple items in a single request, each with optional associated payments and custom pricing. Returns the successfully posted items. Required: items.
• List List all Cloudbeds market segmentation groups List Cloudbeds market segmentation groups. Returns: id. Max 500 per page.
• Create Create a Cloudbeds market segmentation group Create a new Cloudbeds market segmentation group. Returns: id.
• Get Get single Cloudbeds market segmentation group by ID Get a single Cloudbeds market segmentation group by id. Returns: id. Required: id.
• Update Update a Cloudbeds market segmentation group by ID Update a Cloudbeds market segmentation group by id. Returns: id. Required: id.
• Delete Delete a Cloudbeds market segmentation group by ID Delete a Cloudbeds market segmentation group by id. Returns an empty 204 response on success. Required: id.
• Enable Cloudbeds market segmentation groups enable Enable a Cloudbeds market segmentation group. Returns an empty 204 response on success. Required: group_id.
• Disable Cloudbeds market segmentation groups disable Disable a Cloudbeds market segmentation group. Returns an empty 204 response on success. Required: group_id.
• List List all Cloudbeds market segmentation segments List Cloudbeds market segmentation segments filtered by enabled status. Returns: id. Required: enabled.
• Update Update a Cloudbeds market segmentation segment by ID Update a Cloudbeds market segmentation segment by id. Returns: id. Required: id.
• Delete Delete a Cloudbeds market segmentation segment by ID Delete a Cloudbeds market segmentation segment by id. Returns an empty 204 response on success. Required: id.
• Create Create a Cloudbeds market segmentation segment Create a new market segmentation segment in Cloudbeds. Returns: id.
• Enable Cloudbeds market segmentation segments enable Enable a Cloudbeds market segmentation segment by id. Returns an empty 204 response on success. Required: segment_id.
• Disable Cloudbeds market segmentation segments disable Disable a Market Segmentation Segment in Cloudbeds. Returns an empty 204 response on success. Required: segment_id.
• List List all Cloudbeds segment reservations List reservations linked to a Cloudbeds Market Segmentation Segment, filtered by active status. Returns: data (array of reservation records with id). Required: segment_id, active.
• List List all Cloudbeds property systems List Cloudbeds property system component versions for the authenticated property context. Returns: attributes containing system component version information defined by the upstream SystemResponseSchema.
• List List all Cloudbeds rates rate plans List Cloudbeds rate plans for one or more properties. Returns: id, created_at, updated_at. Max 500 items per page.
• Create Create a Cloudbeds rates rate plan Create a new Cloudbeds rate plan. Returns: id, created_at, updated_at. Required: a JSON request body with rate plan data.
• Get Get single Cloudbeds rates rate plan by ID Get a single Cloudbeds rate plan by id. Returns: id, created_at, updated_at. Required: id.
• Update Update a Cloudbeds rates rate plan by ID Update an existing Cloudbeds rate plan by id. Returns: id, created_at, updated_at. Required: id and a JSON request body with rate plan data.
• Delete Delete a Cloudbeds rates rate plan by ID Delete a Cloudbeds rate plan by id. Returns an empty 204 response on success. Required: id.
• Create Create a Cloudbeds payments preview adjustment Preview how a folio adjustment (tax, fee, rate, or room-revenue) would affect Cloudbeds Smart Policy scheduled payments without actually applying the change. Returns the adjustment preview result object showing how the scheduled payments would be recalculated. Required: a JSON request body describing the folio adjustment to preview.
• List List all Cloudbeds reservation policy informations Get the rendered smart policy text and scheduled payments for a Cloudbeds reservation. Returns: policyText, policyTextSource. Required: reservation_id. Falls back to legacy cancellation policy text when no smart policy applies; returns null policyText when neither is available.
• List List all Cloudbeds search exceptions eligible rates Search eligible rate plans and base rates with conflict info in Cloudbeds. Returns eligible rate plans and base rates with conflict information. Requires a search criteria request body.
• List List all Cloudbeds smart policies exceptions List all Cloudbeds policy exceptions for a property. Returns: id. Supports dynamic filtering and multi-field sorting.
• Create Create a Cloudbeds smart policies exception Create a new Cloudbeds policy exception. Returns: id. A 409 conflict is returned if the exception overlaps with an existing one.
• Get Get single Cloudbeds smart policies exception by ID Get a single Cloudbeds policy exception by id. Returns: id. Required: id.
• Update Update a Cloudbeds smart policies exception by ID Update an existing Cloudbeds policy exception by id. Returns: id. Required: id. A 409 conflict is returned if the updated exception overlaps with an existing one.
• Delete Delete a Cloudbeds smart policies exception by ID Delete a Cloudbeds policy exception by id. Returns an empty 204 response on success. Required: id.
• Update Cloudbeds smart policies exceptions partial update Partially update a Cloudbeds smart policy exception by id. Returns the updated policy exception including its exceptionId, checkin_date, and checkout_date. Required: id.
• Get Get single Cloudbeds dataset cdf by ID Get the picklist options for a specific Cloudbeds Data Field (CDF) within a dataset. Returns the available option values for the specified CDF column. Required: dataset_id (integer 1–9), id (CDF column name reference, e.g. reservation_status).
• Get Get single Cloudbeds dataset multi level cdf by ID Get the CDF (Cloudbeds Data Field) picklist options for a specific multi-level within a Cloudbeds dataset. Returns the CDFOptions object containing available picklist values for the requested CDF. Required: dataset_id, multi_level_id, id.
• Create Create a Cloudbeds stock report query datum Query stock report data from an existing Cloudbeds stock report, allowing overrides to filters, columns, group rows, group columns, sort, and settings. Returns: columns, settings, headers, records, index, group_rows, group_columns, periods. Required: stock_report_id, mode. Preview mode is limited to 100 records and Run mode to 12,000 records.
• Create Create a Cloudbeds stock report query summary Query a Cloudbeds stock report summary from an existing stock report with custom filters, columns, group rows, group columns, sort, and settings overrides. Returns: columns, group_rows, group_columns, periods, settings. Required: stock_report_id, mode. Preview mode limits to 100 records; Run mode limits to 12,000 records.
• Create Create a Cloudbeds stock report query export Create a file export of queried stock report data from a Cloudbeds stock report that has not been created yet. Returns the exported data structure including columns, settings, group_rows, group_columns, and periods, with format varying by report type. Required: stock_report_id, view, format, type. Supports up to 100000 records in export mode.
• Create Create a Cloudbeds report query export async Queue an async export task for report query data in Cloudbeds. Accepts a report query definition body specifying type, columns, settings, and optional group/period structures. Returns: queueTaskId, status, timestamp. Required: view, format, type, columns, and settings. Export mode supports up to 100000 records.
• Create Create a Cloudbeds report bulk export async Queue a task in Cloudbeds to export multiple reports by ids as a single Excel workbook. Returns a queue response with a token for tracking the async export task status. Required: report_ids. Supports 1–15 report ids per request; workbook name defaults to 'Workbook' and is limited to 32 characters.
• Create Create a Cloudbeds stock report export async Queue an asynchronous export task for a Cloudbeds stock report by id, producing a file in the requested format. Returns a QueueResponse with queueTaskId, queueTaskId_str, and status for tracking the export job. Required: stock_report_id, format, property_ids, view.
• Create Create a Cloudbeds stock report query export async Create an asynchronous stock report query export in Cloudbeds by submitting a stock report query specification. Queues a file export of up to 100,000 records; the report type in the body determines the data structure. Returns: id, status. Required: stock_report_id, view, format, type.
• Update Cloudbeds stock report custom cdf validates bulk update Validate a custom CDF formula for a Cloudbeds stock report before creation. The formula is a list of objects each containing kind (cdf, separator, operator, operand, parenthesis) and value. Returns: name, formula. Required: stock_report_id.
• Create Create a Cloudbeds stock report folder report Assign a stock report to a stock report folder in Cloudbeds to organize reports. Returns an empty 201 response on success. Required: folder_id, stock_report_id.
• List List all Cloudbeds fiscal document transaction summaries Get totals of transactions for a given fiscal document in Cloudbeds. Returns a FiscalDocumentTransactionsSummary object with aggregated transaction totals for the specified document. Required: fiscal_document_id.
• Create Create a Cloudbeds segment default Set a Cloudbeds Market Segmentation Segment as the default segment. Returns an empty 204 response on success. Required: segment_id.

No tools match your search.