--- title: Cloudbeds API Integration on Truto slug: cloudbeds category: Travel canonical: "https://truto.one/integrations/detail/cloudbeds/" --- # Cloudbeds API Integration on Truto **Category:** Travel **Status:** Beta ## MCP-ready AI tools Truto exposes 555 tools for Cloudbeds that AI agents can call directly. - **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_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_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. - **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_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_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_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_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_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_a_cloudbeds_create_allotment_block_note** — Create a note on an allotment block in Cloudbeds. Returns: success, data. - **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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_a_cloudbeds_post_guest_note** — Create a guest note in Cloudbeds for a specific guest. Returns: success, guestNoteID, message. - **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. - **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. - **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. - **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_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_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_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_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_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_all_cloudbeds_get_hotel_details** — Get the details of a specific Cloudbeds hotel (property) identified by propertyID. Returns: success, data. - **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_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_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_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. - **cloudbeds_put_house_account_status_bulk_update** — Update a specific Cloudbeds house account's status to either open or closed. Returns: success, message. - **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_a_cloudbeds_post_housekeeping_status** — PostHousekeepingStatus. Returns: success, data, message. - **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. - **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_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_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_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_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_a_cloudbeds_post_government_receipt** — Add a Government Receipt to a reservation or house account in Cloudbeds. Returns the created government receipt response. - **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_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_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. - **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_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_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_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. - **cloudbeds_put_item_to_inventories_bulk_update** — PutItemToInventory. Returns: success, message. - **list_all_cloudbeds_get_item_categories** — List item categories in Cloudbeds. Returns: success, and data (an array of item category objects). - **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_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_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_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_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_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_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_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_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_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_all_cloudbeds_get_payment_methods** — List active payment methods for a Cloudbeds property or list of properties. Returns: success, data. - **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_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_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_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_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_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_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_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_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_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_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_single_cloudbeds_get_reservation_by_id** — Get a single Cloudbeds reservation by reservationID. Returns: success, data, message. Required: reservation_i_d. - **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_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_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_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_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. - **cloudbeds_put_reservation_notes_bulk_update** — Update an existing reservation note in Cloudbeds with new content. Returns: success, message. - **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_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. - **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_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_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_a_cloudbeds_post_room_assign** — Assign or reassign a room on a guest reservation in Cloudbeds. Returns: success, message. - **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_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_all_cloudbeds_get_reservation_room_details** — GetReservationRoomDetails. Returns: success, message, data. Required: sub_reservation_i_d. - **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_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. - **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_a_cloudbeds_delete_room_block** — Delete a room block in Cloudbeds by providing its room block ID. Returns: success, message. - **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_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_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_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_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_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_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_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. - **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_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_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_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_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. - **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_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_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_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_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. - **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_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_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. - **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_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. - **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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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. - **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_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_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_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_all_cloudbeds_configurations_sources** — Get which folio configuration is assigned to a source in Cloudbeds. Returns: sourceId, sourceKind, folioConfigurationId. Required: sourceId, sourceKind. - **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_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_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. - **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_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_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_a_cloudbeds_attribute_tagging_attribute** — Create a new attribute tagging attribute in Cloudbeds. Returns: id, label, description, entityTypes, isEnabled. Required: label, entityTypes. - **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_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_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_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. - **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_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_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_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_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_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_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_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_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_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_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_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_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_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_single_cloudbeds_group_profile_contact_person_by_id** — Get a single Cloudbeds contact person by id. Returns: id, createdAt, updatedAt. Required: id. - **update_a_cloudbeds_group_profile_contact_person_by_id** — Update a Cloudbeds contact person by id. Returns: id, createdAt, updatedAt. Required: id. - **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_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_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_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_a_cloudbeds_profile_note_by_id** — Delete a note from a Cloudbeds profile. Returns an empty 204 response on success. Required: profile_id, id. - **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. - **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_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_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_all_cloudbeds_profile_tags** — List all tags assigned to a Cloudbeds group profile. Returns: id, profileId, tag. Required: profile_id. - **create_a_cloudbeds_profile_tag** — Assign a tag to a Cloudbeds group profile. Returns: id, profileId, tag. Required: profile_id, tag. - **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_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_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_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_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_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_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_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_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_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_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_all_cloudbeds_profiles_filters** — List available filter values for guest profiles in Cloudbeds. Returns: countries, guestStatuses, 5XX. Required: organization_id. - **list_all_cloudbeds_profile_sources** — List the sources of a Cloudbeds profile. Returns: name, date, 5XX. Required: profile_id. - **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_all_cloudbeds_merges_suggesteds** — List suggested guest profile merges in Cloudbeds. Returns: suggestions. Required: organization_id. Filterable by profileId. - **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_all_cloudbeds_profile_reservations** — List reservations for a specific Cloudbeds guest profile. Returns: id. Required: profile_id. - **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_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_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_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_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. - **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_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_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_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_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_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_all_cloudbeds_v_1_1_folders** — List all report folders created under a Cloudbeds property. Returns: id, name, parent_id. - **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_single_cloudbeds_v_1_1_folder_by_id** — Get a single Cloudbeds report folder by id. Returns: id, name, parent_id. Required: id. - **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_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_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_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_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_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_a_cloudbeds_v_1_1_hub** — Create a new Cloudbeds data insights hub. Returns: id, description, created_at, updated_at. - **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_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_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. - **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_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_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_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_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_all_cloudbeds_datainsights_v_1_1_s** — Get profile data about the current Cloudbeds user from the Data Insights API. Returns: data. - **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_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_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_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_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_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_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_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. - **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. - **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_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_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_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_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_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_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_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_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_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_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_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_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. - **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_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_all_cloudbeds_report_tags** — List all tags associated with a Cloudbeds report. Returns: id, tag_id, name. Required: report_id. - **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_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_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_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_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_all_cloudbeds_report_charts** — List all charts for a specific Cloudbeds report. Returns: id, created_at, updated_at. Required: report_id. - **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_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_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_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_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_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_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_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_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_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_single_cloudbeds_v_1_1_schedule_by_id** — Get a single Cloudbeds schedule by id. Returns: id, created_at, updated_at. Required: id. - **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_a_cloudbeds_v_1_1_schedule_by_id** — Delete a Cloudbeds schedule by id. Returns an empty 204 response on success. Required: id. - **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_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_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_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_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_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. - **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. - **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. - **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_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_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_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_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_all_cloudbeds_rules_property_ids** — List supported property ID rule keys for Cloudbeds stock reports. Returns: key. - **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_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_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_all_cloudbeds_stock_report_revisions** — List revisions for a Cloudbeds stock report. Returns: id, created_at. Required: stock_report_id. - **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_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_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_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_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_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_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_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_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_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_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_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_a_cloudbeds_stock_reports_folder** — Create a new stock report folder in Cloudbeds to organize stock reports. Returns: id, name. Required: name. - **get_single_cloudbeds_stock_reports_folder_by_id** — Get a single stock report folder by id in Cloudbeds. Returns: id, name. Required: id. - **delete_a_cloudbeds_stock_reports_folder_by_id** — Delete a stock report folder by id. Returns an empty 204 response on success. Required: id. - **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_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_all_cloudbeds_v_1_1_tags** — List all tags created under a Cloudbeds property. Returns: id, name. - **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_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_a_cloudbeds_v_1_1_tag_by_id** — Delete a Cloudbeds tag by id. Returns an empty 204 response on success. Required: id. - **list_all_cloudbeds_v_1_1_favorites** — List all Cloudbeds report favorites for the authorized user on a specific property. Returns: id. - **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_single_cloudbeds_v_1_1_favorite_by_id** — Get a single Cloudbeds report favorite by id. Returns: id. Required: id. - **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_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_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_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_all_cloudbeds_v_1_1_tasks** — List all Data Insights tasks for a single Cloudbeds property. Returns: id. Max 100 results per page. - **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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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. - **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_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_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_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_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_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_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_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_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_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. - **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_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_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_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_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_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_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). - **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_all_cloudbeds_configs_logos** — Get the logo image used in fiscal document templates in Cloudbeds, returned as a presigned URL. Returns: logoUrl. - **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. - **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. - **cloudbeds_configs_logos_bulk_delete** — Delete the logo image used in fiscal document templates in Cloudbeds. Returns an empty 204 response on success. - **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_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_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. - **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_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_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_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_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_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_a_cloudbeds_registration_validate** — Validate fiscalization registration party data in Cloudbeds against country-specific fiscalization rules based on the regime field. Returns: valid. - **list_all_cloudbeds_registration_countries** — List countries available for fiscalization property registration in Cloudbeds, based on the property's location. Returns: name. - **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_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_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_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_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_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_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. - **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_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_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. - **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_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_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. - **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_all_cloudbeds_fiscalization_customizations** — Get the fiscalization customization configuration for a Cloudbeds property. Returns: logo, locale, layout. - **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_all_cloudbeds_customization_logos** — Get the fiscalization customization logo in Cloudbeds, returning a presigned URL for the logo image. Returns: url. - **create_a_cloudbeds_customization_logo** — Upload a logo image for the fiscalization customization in Cloudbeds. Returns an empty response on success. Required: file. - **cloudbeds_customization_logos_bulk_delete** — Delete the fiscalization customization logo in Cloudbeds. Returns an empty response on success. - **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_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_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_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. - **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_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. - **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_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_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_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_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). - **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. - **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. - **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_all_cloudbeds_catalogue_countries** — List supported countries available for Cloudbeds fiscalization. Returns: code, name. No required parameters. - **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_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_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_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_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_single_cloudbeds_fiscalization_connection_by_id** — Get a single fiscalization connection by id in Cloudbeds. Returns: id. Required: id. - **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_a_cloudbeds_fiscalization_connection_by_id** — Disconnect a fiscalization connection by id in Cloudbeds. Returns an empty 204 response on success. Required: id. - **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. - **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. - **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_a_cloudbeds_connection_test** — Test a Cloudbeds fiscalization connection to the tax authority. Returns the connection test result. Required: connection_id. - **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_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_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_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_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_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_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. - **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. - **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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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_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. - **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_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_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_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_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_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. - **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_all_cloudbeds_propertie_room_amenities** — List active room amenities for all rooms in a Cloudbeds property. Returns: id. Required: property_id. - **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_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. - **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_all_cloudbeds_integration_connected_applications** — List connected API clients (applications) for a Cloudbeds property, optionally filtered by OAuth scopes. Returns: clientId, scopes. - **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_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_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_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. - **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_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_a_cloudbeds_doorlock_key_by_id** — Delete a Cloudbeds doorlock key by id. Returns an empty 204 response on success. Required: id. - **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_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_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_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_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_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_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_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_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_a_cloudbeds_event_note** — Create a new note for a Cloudbeds event. Returns: id, content, createdAt, updatedAt. Required: event_id, content. - **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_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_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_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_single_cloudbeds_housekeeping_inspection_by_id** — List housekeeping inspections for a Cloudbeds property. Returns: id. Required: id, propertyId. - **list_all_cloudbeds_integration_events** — List Cloudbeds integration event subscriptions for a specific property. Returns: id. Max 500 per page. - **create_a_cloudbeds_integration_event** — Create a new Cloudbeds integration event subscription. Returns: id. Required: event, subscriptionData. - **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_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_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_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_all_cloudbeds_market_segmentation_groups** — List Cloudbeds market segmentation groups. Returns: id. Max 500 per page. - **create_a_cloudbeds_market_segmentation_group** — Create a new Cloudbeds market segmentation group. Returns: id. - **get_single_cloudbeds_market_segmentation_group_by_id** — Get a single Cloudbeds market segmentation group by id. Returns: id. Required: id. - **update_a_cloudbeds_market_segmentation_group_by_id** — Update a Cloudbeds market segmentation group by id. Returns: id. Required: id. - **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. - **cloudbeds_market_segmentation_groups_enable** — Enable a Cloudbeds market segmentation group. Returns an empty 204 response on success. Required: group_id. - **cloudbeds_market_segmentation_groups_disable** — Disable a Cloudbeds market segmentation group. Returns an empty 204 response on success. Required: group_id. - **list_all_cloudbeds_market_segmentation_segments** — List Cloudbeds market segmentation segments filtered by enabled status. Returns: id. Required: enabled. - **update_a_cloudbeds_market_segmentation_segment_by_id** — Update a Cloudbeds market segmentation segment by id. Returns: id. Required: id. - **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_a_cloudbeds_market_segmentation_segment** — Create a new market segmentation segment in Cloudbeds. Returns: id. - **cloudbeds_market_segmentation_segments_enable** — Enable a Cloudbeds market segmentation segment by id. Returns an empty 204 response on success. Required: segment_id. - **cloudbeds_market_segmentation_segments_disable** — Disable a Market Segmentation Segment in Cloudbeds. Returns an empty 204 response on success. Required: segment_id. - **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_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_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_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_single_cloudbeds_rates_rate_plan_by_id** — Get a single Cloudbeds rate plan by id. Returns: id, created_at, updated_at. Required: id. - **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_a_cloudbeds_rates_rate_plan_by_id** — Delete a Cloudbeds rate plan by id. Returns an empty 204 response on success. Required: id. - **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_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_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_all_cloudbeds_smart_policies_exceptions** — List all Cloudbeds policy exceptions for a property. Returns: id. Supports dynamic filtering and multi-field sorting. - **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_single_cloudbeds_smart_policies_exception_by_id** — Get a single Cloudbeds policy exception by id. Returns: id. Required: id. - **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_a_cloudbeds_smart_policies_exception_by_id** — Delete a Cloudbeds policy exception by id. Returns an empty 204 response on success. Required: id. - **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_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_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_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_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_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_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_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_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_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. - **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_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_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_a_cloudbeds_segment_default** — Set a Cloudbeds Market Segmentation Segment as the default segment. Returns an empty 204 response on success. Required: segment_id. ## How it works 1. **Link your customer's Cloudbeds account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Cloudbeds.** The Proxy API is a 1-to-1 mapping of the Cloudbeds API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed Cloudbeds sync in your POS or F&B platform** — Restaurant, bar, and retail POS vendors can let hoteliers charge tabs directly to guest folios in Cloudbeds, eliminating manual re-entry at the front desk and stopping revenue leakage between systems. - **Power automated revenue and rate optimization** — Revenue management and pricing SaaS can ingest live reservation, occupancy, and rate plan data from Cloudbeds and push optimized rates back via rate and rate plan endpoints, giving hoteliers dynamic pricing without a custom integration project. - **Ship a guest engagement and upsell layer** — Guest communication and upsell platforms can trigger on new reservations via webhooks, post custom items and charges to folios, and write reservation notes so front-desk staff can fulfill purchases like late check-outs, transfers, or upgrades. - **Automate hotel accounting and fiscal reconciliation** — Accounting middleware and ERP connectors can map Cloudbeds transaction codes to custom GL codes, pull trial balances, AR ledgers, and fiscal documents, and sync balanced journal entries into Xero, QuickBooks, or NetSuite nightly. - **Deliver contactless check-in and smart access** — Digital key and IoT lock vendors can drive the full mobile check-in flow — capturing guest documents, posting check-in, and issuing doorlock keys — so guests bypass the front desk entirely. ## What you can build - **Folio charge posting from external POS** — Push F&B checks, custom items, and gratuities directly onto guest or group folios using folio check, custom item, and gratuity endpoints. - **Two-way rate and availability sync** — Pull rate plans, allotment blocks, and room availability, then push updated rates and inventory back to Cloudbeds for automated pricing decisions. - **Reservation-driven guest workflows** — Subscribe to Cloudbeds webhooks for new and modified reservations to trigger pre-arrival emails, upsells, ID capture, and internal reservation notes. - **Nightly financial close automation** — Query transactions, trial balance reports, AR ledgers, and deposit balances to generate journal entries and reconcile against custom GL code mappings. - **Fiscal document and invoice sync** — Retrieve country-compliant invoices, credit notes, receipts, and their allocations from the fiscalization endpoints and mirror them into finance or archival systems. - **Mobile check-in with digital key issuance** — Combine guest document uploads, room check-in, and doorlock key creation to deliver a fully contactless arrival flow inside your app. ## FAQs ### How does authentication with Cloudbeds work through Truto? Cloudbeds uses OAuth 2.0. Truto handles the full OAuth flow — token exchange, storage, and refresh — so your end users connect their Cloudbeds account with a standard consent screen and you never touch credentials. ### Can we react to changes in Cloudbeds in real time? Yes. Cloudbeds supports webhooks, and you can register and manage subscriptions programmatically via the webhook endpoints to receive events like new reservations, modifications, and check-ins instead of polling. ### Does the integration support multi-property hotel groups? Yes. Cloudbeds exposes hotel, property, and sub-property endpoints, and most resources are scoped by property, so you can support hotel groups and chains with property-level operations from a single connected account. ### Can we post charges and payments to a guest's folio? Yes. You can post items, custom items, adjustments, payments, and charges, as well as create and update folios, move and route transactions between folios, and apply autorouting rules via the folios rules endpoints. ### Does the API expose custom fields and tags? Yes. Cloudbeds supports custom fields on core objects, profile custom fields, attribute tagging, and custom Cloudbeds Data Fields (CDFs) in reports, all of which are accessible through their respective endpoints. ### How do we handle large data exports without hitting pagination limits? Cloudbeds provides asynchronous export endpoints for reports and stock reports (including bulk export async), which are the recommended path for pulling large datasets, trial balances, or historical transactions. ### Is country-specific fiscal compliance supported? Yes. Cloudbeds has a dedicated fiscalization suite covering invoices, credit notes, rectifying invoices, receipts, pro forma invoices, allocations, and provider-specific connections, credentials, and routing for markets that require government fiscal reporting. ## Related reading - [Connect Cloudbeds to ChatGPT: Manage Bookings and Guest Relations](https://truto.one/blog/connect-cloudbeds-to-chatgpt-manage-bookings-and-guest-relations/) — A step-by-step engineering guide to generating a managed MCP server for Cloudbeds, connecting it to ChatGPT, and automating PMS operations without writing code. - [Connect Cloudbeds to Claude: Automate Billing and Folio Accounting](https://truto.one/blog/connect-cloudbeds-to-claude-automate-billing-and-folio-accounting/) — Learn how to build a secure, managed MCP server for Cloudbeds to give Claude secure access to folios, ledgers, adjustments, and automated invoicing. - [Connect Cloudbeds to AI Agents: Sync Property Ops and Analytics](https://truto.one/blog/connect-cloudbeds-to-ai-agents-sync-property-ops-and-analytics/) — A complete engineering guide to connecting Cloudbeds to AI agents using Truto's /tools endpoint. Learn to automate property operations, folio accounting, and OTA rate management.