# Cloudbeds MCP connector The Cloudbeds connector brings group allotment blocks, folio adjustments, guest email templates and schedules, custom fields, property settings and dashboards to Claude, ChatGPT, Cursor and any MCP client, with every action tied to the person who signed in. Source: https://elaichi.ai/connectors/cloudbeds/ ## Facts | | | | --- | --- | | Application | Cloudbeds | | Category | Travel | | AI tools | 555 | | Authentication | Connects over OAuth | | Needs your own OAuth app | Yes | | MCP endpoint | https://api.elaichi.ai/mcp | | Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent | | Tools advertised by name | No. 555 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` | ## What you can ask once Cloudbeds is connected - Which allotment blocks still have unsold rooms this weekend? - Summarize adjustments posted against the Lisbon property yesterday. - Add a note to the group allotment block for March. ## Connect Cloudbeds in Elaichi This happens once for the organization, before any client is involved. 1. Open Connections, choose Add connection, and pick Cloudbeds. 2. Optionally set Share with, then press Connect. 3. Supply your own Cloudbeds app, then approve. Cloudbeds needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization. Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Cloudbeds tools are exposed, rename them, or freeze arguments before anyone points a client at it. ## Connect Cloudbeds to Claude Endpoint: https://api.elaichi.ai/mcp 1. Open Customize, then Connectors. 2. Press Add. 3. Name it, paste the MCP server URL, then Continue. 4. Sign in and approve. On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves. ## Connect Cloudbeds to ChatGPT Endpoint: https://api.elaichi.ai/mcp 1. Open Plugins, then press the + button. 2. Name it and paste the endpoint into Server URL. 3. Leave Authentication on OAuth, then tick the risk acknowledgement. 4. Press Create, then sign in and approve. Works on the web today. The plugin directory lives at chatgpt.com/plugins. ## Connect Cloudbeds to Cursor Endpoint: https://api.elaichi.ai/mcp 1. Open `~/.cursor/mcp.json`. 2. Add the endpoint under `mcpServers`. 3. Reload Cursor, then sign in and approve. Set up per machine, so repeat it on each computer you work from. ## Connect Cloudbeds to any MCP client Endpoint: https://api.elaichi.ai/mcp 1. Add the endpoint as a remote MCP server. 2. Sign in and approve. The Elaichi Agent already has these tools, with nothing to set up. ## What the consent screen decides Only Read is granted by default, which is not enough to call a Cloudbeds tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone. ## What teams do with Cloudbeds through Elaichi ### Set up a group block once the contract signs Group sales. Create the allotment block in Cloudbeds with the agreed dates and room count, then add the notes from the contract so the front desk sees the terms without asking. ### Adjust a block when the group changes Reservations. Update the allotment block when the organizer adds rooms or shifts dates, and drop the block cleanly if the group cancels. ### Post a folio adjustment during checkout Front desk. Apply a credit for a maintenance issue or a correction for a misposted charge in Cloudbeds while the guest is still at the desk. ### Reverse a batch of adjustments posted in error Finance. Remove a set of mistaken adjustments in one pass instead of opening each folio, with a record of who did it and when. ### Draft and schedule pre-arrival emails Guest communications. Write a new email template for early check-in offers or parking instructions, then set the schedule so it goes out a set number of days before arrival. ### Check settings and custom fields across properties Operations. Pull the property settings, currency settings and custom fields for each hotel in Cloudbeds, spot the ones that drifted, and add a missing custom field where a property needs it. ## Frequently asked questions ### How do I connect Cloudbeds to Claude? Two steps. First, connect Cloudbeds in Elaichi: Cloudbeds asks you to register an OAuth application in your own Cloudbeds account, so one person brings that client ID and secret once, then signs in to Cloudbeds and approves the connection. Second, in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Claude then signs you in through Elaichi and Cloudbeds is available in your conversations. ### Does Cloudbeds work with ChatGPT and Cursor as well as Claude? Yes. Once Cloudbeds is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Cloudbeds once and every client you use picks it up. ### What can an AI agent actually do with my Cloudbeds data? It can create, update and remove group allotment blocks and their notes, post adjustments to folios or reverse a batch of them, read your dashboards, and look up property settings, currency settings and custom fields in Cloudbeds. It can also draft email templates and set email schedules for guest messages. Because Cloudbeds exposes several hundred actions, short concrete asks like "add two rooms to the Morgan wedding block" work better than long paragraphs. ### Does connecting Cloudbeds give the AI access to all my properties? No. Every action runs as the person who signed in to Cloudbeds, so the AI sees only the properties and settings that person can already reach. Elaichi can narrow that further, for example limiting a team to allotment blocks and email templates, but it never grants anything the person could not do in Cloudbeds directly. ### Can my team share one Cloudbeds connection? Yes. One person registers the OAuth application, connects Cloudbeds in Elaichi and shares the connection with a team, and nobody else ever handles the client ID or secret. Each teammate still signs in to Elaichi as themselves, so every allotment block created or adjustment posted in Cloudbeds is logged under their own name. ### Can I stop an agent from deleting or changing things in Cloudbeds? Yes. Restrictions in Elaichi apply per action, so you can allow reading dashboards and property settings while blocking the removal of allotment blocks or the bulk deletion of adjustments in Cloudbeds. A blocked action is never shown to Claude, ChatGPT or Cursor at all, so no prompt, however worded, can reach it. ### What happens to a Cloudbeds connection when someone leaves? Offboarding that person in Elaichi ends their access to Cloudbeds through every client at once. A shared Cloudbeds connection keeps working for everyone else on the team. If you disconnect Cloudbeds in Elaichi, it disappears from Claude, ChatGPT, Cursor and every other client in one step. ## All 555 Cloudbeds tools Every tool below is callable through https://api.elaichi.ai/mcp once Cloudbeds is connected, subject to the toolbox it is in and the restrictions on the caller. - **List all Cloudbeds oauth metadata** (List). 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). 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** (List). 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** (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** (Create). 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). 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** (Create). 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). 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** (Create). 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). Create a note on an allotment block in Cloudbeds. Returns: success, data. - **List all Cloudbeds list allotment block notes** (List). 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** (Create). 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** (Create). 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** (List). 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). 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). 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** (List). 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). 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). 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** (List). 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). 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). 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). 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). 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). 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). 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** (Create). 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** (Create). 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). 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** (List). 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). 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). 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). 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). 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). Create a guest note in Cloudbeds for a specific guest. Returns: success, guestNoteID, message. - **List all Cloudbeds get guest notes** (List). 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). 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** (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). 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** (Create). 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** (Create). 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** (Create). 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** (Create). 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). 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** (List). Get the details of a specific Cloudbeds hotel (property) identified by propertyID. Returns: success, data. - **Create a Cloudbeds post file** (Create). 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). 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). 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). 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). Update a specific Cloudbeds house account's status to either open or closed. Returns: success, message. - **List all Cloudbeds get housekeeping status** (List). 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** (Create). PostHousekeepingStatus. Returns: success, data, message. - **Create a Cloudbeds post housekeeper** (Create). 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** (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). 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** (Create). 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** (List). 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** (Create). 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** (Create). Add a Government Receipt to a reservation or house account in Cloudbeds. Returns the created government receipt response. - **List all Cloudbeds get app settings** (List). 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** (Create). 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** (Create). 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). 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). 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). 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). 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** (Update). PutItemToInventory. Returns: success, message. - **List all Cloudbeds get item categories** (List). List item categories in Cloudbeds. Returns: success, and data (an array of item category objects). - **Create a Cloudbeds post item category** (Create). 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). 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** (Create). 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** (Create). 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** (Create). 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** (Create). 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). 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). 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** (Create). 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** (Create). 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). List active payment methods for a Cloudbeds property or list of properties. Returns: success, data. - **List all Cloudbeds get payments capabilities** (List). 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** (Create). 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** (Create). 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** (Create). 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** (List). 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). 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). 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** (Get). 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** (Create). 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** (Create). 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). 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). Get a single Cloudbeds reservation by reservationID. Returns: success, data, message. Required: reservation_i_d. - **Create a Cloudbeds post reservation** (Create). 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). 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). 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** (Create). 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). 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). Update an existing reservation note in Cloudbeds with new content. Returns: success, message. - **Cloudbeds delete reservation notes bulk delete** (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** (Create). 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). 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). 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** (List). 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** (Create). Assign or reassign a room on a guest reservation in Cloudbeds. Returns: success, message. - **Create a Cloudbeds post room check in** (Create). 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** (Create). 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** (List). GetReservationRoomDetails. Returns: success, message, data. Required: sub_reservation_i_d. - **Create a Cloudbeds post room block** (Create). 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). 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). 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** (Create). Delete a room block in Cloudbeds by providing its room block ID. Returns: success, message. - **List all Cloudbeds get room types** (List). 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** (Get). 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). 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). 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). 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). 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). 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** (List). 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). 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** (Create). 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). 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). 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). 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). 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). 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** (List). 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** (Create). 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** (List). 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** (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** (Create). 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). 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** (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). 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). 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** (Create). 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** (List). 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). 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). 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). 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). 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** (Create). 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** (Create). 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** (Create). 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** (List). 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** (List). 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). 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** (List). 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** (Create). 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** (List). 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** (Create). 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** (List). 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). 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** (List). 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). 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** (List). 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). 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). 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** (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). 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** (Update). 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). 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** (List). Get which folio configuration is assigned to a source in Cloudbeds. Returns: sourceId, sourceKind, folioConfigurationId. Required: sourceId, sourceKind. - **Cloudbeds configurations sources bulk update** (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). 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). 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). 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** (List). 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). 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). 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). 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). Delete a Cloudbeds attribute tagging attribute by id. Returns an empty 204 response on success. Required: id. - **List all Cloudbeds attribute tagging tags** (List). 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** (Create). 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). 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). Delete a single attribute tag in Cloudbeds by id. Returns an empty 204 response on success. Required: id. - **Create a Cloudbeds tags query** (Create). 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). 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). 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). 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). 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). 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). 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). 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** (Delete). 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** (Get). 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). 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). 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). Get a single Cloudbeds contact person by id. Returns: id, createdAt, updatedAt. Required: id. - **Update a Cloudbeds group profile contact person by ID** (Update). Update a Cloudbeds contact person by id. Returns: id, createdAt, updatedAt. Required: id. - **Delete a Cloudbeds group profile contact person by ID** (Delete). Delete a Cloudbeds contact person by id. Returns an empty 204 response on success. Required: id. - **List all Cloudbeds profile notes** (List). 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). 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). 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). Delete a note from a Cloudbeds profile. Returns an empty 204 response on success. Required: profile_id, id. - **Cloudbeds profile notes archive** (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). 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). 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). 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). List all tags assigned to a Cloudbeds group profile. Returns: id, profileId, tag. Required: profile_id. - **Create a Cloudbeds profile tag** (Create). Assign a tag to a Cloudbeds group profile. Returns: id, profileId, tag. Required: profile_id, tag. - **List all Cloudbeds profile documents** (List). 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** (Create). 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). 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). Get metadata for a specific Cloudbeds profile document by id. Returns: id, fileName, createdAt, updatedAt. Required: profile_id, id. - **List all Cloudbeds document downloads** (List). 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). 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). 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). 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). 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** (List). 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). 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). List available filter values for guest profiles in Cloudbeds. Returns: countries, guestStatuses, 5XX. Required: organization_id. - **List all Cloudbeds profile sources** (List). List the sources of a Cloudbeds profile. Returns: name, date, 5XX. Required: profile_id. - **Create a Cloudbeds profile anonymize** (Create). 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). List suggested guest profile merges in Cloudbeds. Returns: suggestions. Required: organization_id. Filterable by profileId. - **List all Cloudbeds profile custom fields** (List). 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). List reservations for a specific Cloudbeds guest profile. Returns: id. Required: profile_id. - **List all Cloudbeds profile merged profiles** (List). 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). 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** (Create). 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** (Create). 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). 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). 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). 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). 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** (List). 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). 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). 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). List all report folders created under a Cloudbeds property. Returns: id, name, parent_id. - **Create a Cloudbeds v 1 1 folder** (Create). 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). 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). 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). 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** (Create). 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** (Delete). 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** (List). 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). 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). Create a new Cloudbeds data insights hub. Returns: id, description, created_at, updated_at. - **Get single Cloudbeds v 1 1 hub by ID** (Get). 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). 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). Delete a Cloudbeds data insights hub by id. Returns an empty 204 response on success. Required: id. - **Cloudbeds v 1 1 hubs search** (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** (List). 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). 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). Delete a Cloudbeds hub card by id. Returns an empty 204 response on success. Required: hub_id, id. - **Create a Cloudbeds hub card** (Create). 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** (List). Get profile data about the current Cloudbeds user from the Data Insights API. Returns: data. - **Cloudbeds datainsights v 1 1 s search** (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). 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). 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). 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). 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). 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). 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). Delete a Cloudbeds Data Insights report by id. Returns an empty 204 response on success. Required: id. - **Cloudbeds v 1 1 reports clone** (Action). 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). 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** (List). 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** (List). 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** (List). 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). 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** (Create). 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** (Create). 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** (Create). 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). 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). 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). 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). 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). 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** (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). 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). List all tags associated with a Cloudbeds report. Returns: id, tag_id, name. Required: report_id. - **Create a Cloudbeds report tag** (Create). 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). 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** (List). 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). 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). 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). List all charts for a specific Cloudbeds report. Returns: id, created_at, updated_at. Required: report_id. - **Create a Cloudbeds report chart** (Create). 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). 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). 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). 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** (Create). 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). 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). 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). 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). 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). 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). 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). 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). Delete a Cloudbeds schedule by id. Returns an empty 204 response on success. Required: id. - **Create a Cloudbeds schedule run** (Create). 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). 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** (Create). 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). 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). 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** (Delete). Unpublish a Cloudbeds stock report by id. Returns an empty 204 response on success. Required: id. - **Cloudbeds v 1 1 stock reports search** (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** (Action). 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). 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** (List). 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** (List). 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** (List). 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). 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). List supported property ID rule keys for Cloudbeds stock reports. Returns: key. - **List all Cloudbeds rules feature IDS** (List). 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). 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). 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). List revisions for a Cloudbeds stock report. Returns: id, created_at. Required: stock_report_id. - **Get single Cloudbeds stock report revision by ID** (Get). 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). 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). 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). 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). 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). 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). 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). 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). 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). 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). 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). 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). 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). Get a single stock report folder by id in Cloudbeds. Returns: id, name. Required: id. - **Delete a Cloudbeds stock reports folder by ID** (Delete). Delete a stock report folder by id. Returns an empty 204 response on success. Required: id. - **Cloudbeds stock reports folders bulk delete** (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** (List). 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). List all tags created under a Cloudbeds property. Returns: id, name. - **Create a Cloudbeds v 1 1 tag** (Create). 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). 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). Delete a Cloudbeds tag by id. Returns an empty 204 response on success. Required: id. - **List all Cloudbeds v 1 1 favorites** (List). List all Cloudbeds report favorites for the authorized user on a specific property. Returns: id. - **Create a Cloudbeds v 1 1 favorite** (Create). 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). Get a single Cloudbeds report favorite by id. Returns: id. Required: id. - **Update a Cloudbeds v 1 1 favorite by ID** (Update). 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). Delete a Cloudbeds report favorite by id. Returns an empty 204 response on success. Required: id. - **List all Cloudbeds v 1 1 liveneses** (List). 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** (List). 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). 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). 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). 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** (List). 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). 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). 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). 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). 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). 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). 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** (List). 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** (List). 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** (Create). 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). 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). 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** (List). 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** (Create). 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). 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). 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). 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). 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). 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). 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). 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). 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** (Get). 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). 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). 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). 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). 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** (Create). 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** (Create). 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** (Create). 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). 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). 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** (List). Get the logo image used in fiscal document templates in Cloudbeds, returned as a presigned URL. Returns: logoUrl. - **Create a Cloudbeds configs logo** (Create). 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** (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). Delete the logo image used in fiscal document templates in Cloudbeds. Returns an empty 204 response on success. - **List all Cloudbeds configs previews** (List). 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** (List). 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). 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). 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** (List). 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** (List). 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** (Create). 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). 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** (List). 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** (Create). 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). List countries available for fiscalization property registration in Cloudbeds, based on the property's location. Returns: name. - **List all Cloudbeds registration status** (List). 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** (List). 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** (List). 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** (Create). 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** (Get). 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). 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** (List). 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** (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). 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** (List). 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** (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** (List). 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). 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** (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** (List). Get the fiscalization customization configuration for a Cloudbeds property. Returns: logo, locale, layout. - **Cloudbeds fiscalization customizations bulk update** (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** (List). Get the fiscalization customization logo in Cloudbeds, returning a presigned URL for the logo image. Returns: url. - **Create a Cloudbeds customization logo** (Create). Upload a logo image for the fiscalization customization in Cloudbeds. Returns an empty response on success. Required: file. - **Cloudbeds customization logos bulk delete** (Delete). Delete the fiscalization customization logo in Cloudbeds. Returns an empty response on success. - **Get single Cloudbeds fiscalization section by ID** (Get). 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). 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** (List). 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** (List). 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** (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** (List). 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** (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** (List). 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** (Create). 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). 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** (List). 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** (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** (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** (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). List supported countries available for Cloudbeds fiscalization. Returns: code, name. No required parameters. - **List all Cloudbeds countrie channels** (List). 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). 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** (List). 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). 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). 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). Get a single fiscalization connection by id in Cloudbeds. Returns: id. Required: id. - **Update a Cloudbeds fiscalization connection by ID** (Update). 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** (Delete). Disconnect a fiscalization connection by id in Cloudbeds. Returns an empty 204 response on success. Required: id. - **Cloudbeds fiscalization connections activate** (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). 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). 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** (Create). Test a Cloudbeds fiscalization connection to the tax authority. Returns the connection test result. Required: connection_id. - **List all Cloudbeds options** (List). 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** (Create). 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** (Create). 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). 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** (Update). 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** (Delete). 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). 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). 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** (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** (Create). 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** (Create). 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** (Update). 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** (List). 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** (Get). Retrieve a detailed Cloudbeds booking by its OTA booking ID. Returns: success, Booking. Required: verb, booking_id. - **Create a Cloudbeds ack booking** (Create). 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** (Create). 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). 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). 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). 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). 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** (Update). 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** (Update). 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). 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** (Update). 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** (Create). 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** (Create). 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). 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** (Create). 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** (Create). 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). 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). 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). 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). 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). 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). 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). 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). 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** (Get). 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). 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** (Create). 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** (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** (Create). 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). 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). 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). 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). 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** (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). List active room amenities for all rooms in a Cloudbeds property. Returns: id. Required: property_id. - **Cloudbeds propertie room amenities bulk update** (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). 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** (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). List connected API clients (applications) for a Cloudbeds property, optionally filtered by OAuth scopes. Returns: clientId, scopes. - **Create a Cloudbeds folio check** (Create). 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** (Delete). 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** (Get). 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). 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). 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). 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). Delete a Cloudbeds doorlock key by id. Returns an empty 204 response on success. Required: id. - **Get single Cloudbeds doorlock setting by ID** (Get). 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** (Update). 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). 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). 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). 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). 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). 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). 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). 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). 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). 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** (Create). 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** (Delete). Void a posted gratuity by its gratuityId in Cloudbeds. Returns an empty 204 response on success. Required: id. - **Create a Cloudbeds check gratuity** (Create). 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** (Get). List housekeeping inspections for a Cloudbeds property. Returns: id. Required: id, propertyId. - **List all Cloudbeds integration events** (List). List Cloudbeds integration event subscriptions for a specific property. Returns: id. Max 500 per page. - **Create a Cloudbeds integration event** (Create). Create a new Cloudbeds integration event subscription. Returns: id. Required: event, subscriptionData. - **Update a Cloudbeds integration event by ID** (Update). 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** (Create). 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). 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** (Create). 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). List Cloudbeds market segmentation groups. Returns: id. Max 500 per page. - **Create a Cloudbeds market segmentation group** (Create). Create a new Cloudbeds market segmentation group. Returns: id. - **Get single Cloudbeds market segmentation group by ID** (Get). Get a single Cloudbeds market segmentation group by id. Returns: id. Required: id. - **Update a Cloudbeds market segmentation group by ID** (Update). Update a Cloudbeds market segmentation group by id. Returns: id. Required: id. - **Delete a Cloudbeds market segmentation group by ID** (Delete). Delete a Cloudbeds market segmentation group by id. Returns an empty 204 response on success. Required: id. - **Cloudbeds market segmentation groups enable** (Enable). Enable a Cloudbeds market segmentation group. Returns an empty 204 response on success. Required: group_id. - **Cloudbeds market segmentation groups disable** (Disable). Disable a Cloudbeds market segmentation group. Returns an empty 204 response on success. Required: group_id. - **List all Cloudbeds market segmentation segments** (List). List Cloudbeds market segmentation segments filtered by enabled status. Returns: id. Required: enabled. - **Update a Cloudbeds market segmentation segment by ID** (Update). Update a Cloudbeds market segmentation segment by id. Returns: id. Required: id. - **Delete a Cloudbeds market segmentation segment by ID** (Delete). Delete a Cloudbeds market segmentation segment by id. Returns an empty 204 response on success. Required: id. - **Create a Cloudbeds market segmentation segment** (Create). Create a new market segmentation segment in Cloudbeds. Returns: id. - **Cloudbeds market segmentation segments enable** (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). Disable a Market Segmentation Segment in Cloudbeds. Returns an empty 204 response on success. Required: segment_id. - **List all Cloudbeds segment reservations** (List). 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). 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). 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). 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). 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). 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). Delete a Cloudbeds rate plan by id. Returns an empty 204 response on success. Required: id. - **Create a Cloudbeds payments preview adjustment** (Create). 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** (List). 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** (List). 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). List all Cloudbeds policy exceptions for a property. Returns: id. Supports dynamic filtering and multi-field sorting. - **Create a Cloudbeds smart policies exception** (Create). 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). Get a single Cloudbeds policy exception by id. Returns: id. Required: id. - **Update a Cloudbeds smart policies exception by ID** (Update). 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). Delete a Cloudbeds policy exception by id. Returns an empty 204 response on success. Required: id. - **Cloudbeds smart policies exceptions partial update** (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). 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). 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** (Create). 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** (Create). 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). 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** (Create). 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** (Create). 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** (Create). 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). 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** (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** (Create). 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** (List). 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** (Create). Set a Cloudbeds Market Segmentation Segment as the default segment. Returns an empty 204 response on success. Required: segment_id.