1. Getting Started
WinCloud API
  • Getting Started
    • Introduction
    • Quick Start
    • Authentication
    • General
    • Changelog
    • Privacy Policy
    • Terms of Service
    • Support
  • APIs
    • Guests
      • Search Guests
      • Create Guest
      • Get Guest Details
      • Update Guest
      • Get Guest Reservations
      • Get Guest Reference Data
    • Inventory
      • Get Room Inventory
      • Get Room Inventory Details
      • Update Room Inventory
    • Properties
      • Get Customer Properties
      • Get Property Configuration
    • Rates
      • Get Rate Adjustment Templates
      • Get Master Rates
      • Post Master Rates
      • Post Individual Rates
    • Reference Data
      • Get Countries
      • Get Payment Gateways
      • Get Payment Methods
      • Get Currencies
    • Reservations v1
      • Get Reservations
      • Get Cancelled Reservations
      • Get No-Show Reservations
      • Get Reservation Statuses
      • Update Special Instructions
    • Reservations v2
      • List Reservations
      • Get Reservation
    • Rooms
      • Get Rooms
      • Get Room Types
      • Get Rooms Extra Charges
      • Get Rooms Feature Types
      • Get Rooms Tariffs
      • Get Room and Revenue Performance
    • Travel Agents
      • Get Active Travel Agents
    • POS
      • Get Outlet Menu
    • Booking Analytics
      • Get Arrival Summary
      • Get Booking Summary
    • Schemas
      • CodeNameDto
      • ArrivalFiguresDto
      • CompanyDto
      • ArrivalSummaryDto
      • CompanyDtoPaginatedResponse
      • ArrivalSummaryDtoApiResponse
      • CompanyDtoPaginatedResponseApiResponse
      • BookingSummaryDto
      • CountryDto
      • ConfigurationOutletDto
      • BookingSummaryDtoApiResponse
      • CountryDtoApiResponse
      • ConfigurationRoomTypeDto
      • CountryRefDto
      • CurrencyDto
      • CurrencyDtoPaginatedResponse
      • CurrencyDtoPaginatedResponseApiResponse
      • ExtraChargeDto
      • ExtraChargeDtoApiResponse
      • FeatureTypeDto
      • CurrencyRefDto
      • FeatureTypeDtoPaginatedResponse
      • FeatureTypeDtoPaginatedResponseApiResponse
      • GuestCreatedDto
      • GuestAddressDto
      • GuestCreatedDtoApiResponse
      • GuestLookupsDto
      • GuestLookupsDtoApiResponse
      • DepartureFiguresDto
      • GuestPhoneDto
      • GuestPreferencesDto
      • GuestProfileDtoApiResponse
      • GuestProfileDto
      • GuestReservationDtoPaginatedResponse
      • GuestReservationDtoPaginatedResponseApiResponse
      • GuestStaySummaryDto
      • GuestReservationDto
      • GuestProfileRequestDto
      • GuestSummaryItemDto
      • GuestSummaryItemDtoPaginatedResponse
      • GuestPassportDto
      • GuestSummaryItemDtoPaginatedResponseApiResponse
      • InventoryRoomTypeDto
      • InventorySnapshotDto
      • InventorySnapshotDtoPaginatedResponse
      • InventorySnapshotDtoPaginatedResponseApiResponse
      • LanguageRefDto
      • MasterRateBlockDto
      • MasterRateTypeDto
      • MasterRateTypeDtoPaginatedResponse
      • MasterRateTypeDtoPaginatedResponseApiResponse
      • LinkedGuestDto
      • MealPlanDto
      • ObjectApiResponse
      • PayMethodDto
      • PayMethodDtoPaginatedResponse
      • OtaReferenceDto
      • PayMethodDtoPaginatedResponseApiResponse
      • PaymentGatewayDto
      • PaymentGatewayDtoPaginatedResponse
      • PaymentGatewayDtoPaginatedResponseApiResponse
      • ProblemDetails
      • PosMenuItemDto
      • RateAdjustmentTemplateDto
      • PosMenuItemDtoPaginatedResponse
      • RateAdjustmentTemplateDtoPaginatedResponse
      • PosMenuItemDtoPaginatedResponseApiResponse
      • RateAdjustmentTemplateDtoPaginatedResponseApiResponse
      • RatePlanRefDto
      • RecentReservationsDto
      • ReservationBillingDto
      • ReservationCancellationDto
      • PropertyConfigurationDto
      • ReservationEventDtoPaginatedResponse
      • PropertyConfigurationDtoApiResponse
      • ReservationEventDtoPaginatedResponseApiResponse
      • ReservationSourceDto
      • ReservationStatusDto
      • ReservationDtoApiResponse
      • ReservationDtoListApiResponse
      • ReservationStatusDtoListApiResponse
      • ReservationDtoPaginatedResponse
      • ReservationStayStatusDto
      • ReservationDtoPaginatedResponseApiResponse
      • RoomAssignmentItemDto
      • ReservationBookingDto
      • RoomCheckInDto
      • RoomCheckOutDto
      • RoomDto
      • RoomDtoPaginatedResponse
      • RoomDtoPaginatedResponseApiResponse
      • ReservationEventDto
      • RoomInventoryUpdateRequestDto
      • RoomInventoryUpdateResponseDto
      • RoomInventoryUpdateResponseDtoApiResponse
      • RoomRateDto
      • ReservationDto
      • RoomRateDtoPaginatedResponse
      • RoomRateDtoPaginatedResponseApiResponse
      • ReservationRoomDto
      • RoomRateFailureDto
      • RoomRateItemDto
      • RoomRateUpdateRequestDto
      • RoomRateUpdateResponseDto
      • RoomRateUpdateResponseDtoApiResponse
      • ReservationGuestDto
      • RoomTypeDto
      • ReservationOccupancyDto
      • RoomTypeDtoPaginatedResponse
      • RoomTypeDtoPaginatedResponseApiResponse
      • RoomTypeRefDto
      • StaySpendDto
      • TemplateDateRangeDto
      • TitleRefDto
      • TravelAgentDto
      • RoomPerformanceComparisonDto
      • TravelAgentDtoPaginatedResponse
      • RoomPerformanceMetricsDto
      • TravelAgentDtoPaginatedResponseApiResponse
      • RoomPerformancePeriodDto
      • UpdateMasterRatesRequestDto
      • RoomPerformanceResponseDto
      • UpdateMasterRatesResultDto
      • RoomPerformanceResponseDtoApiResponse
      • UpdateMasterRatesResultDtoApiResponse
      • UpdateReservationRequestDto
      • UpdateReservationResponseDtoApiResponse
      • RoomTypePerformanceDto
      • UpdateReservationResponseDto
      • SpecialRequestsDto
  • MCP
    • Overview
    • Connect Your AI Assistant
  • Webhooks
    • Set Up and Edit Webhooks
    • Verify Webhook Signatures
    • List of Webhook Events
  1. Getting Started

Support

WinCloud Open API and WinCloud MCP Server, by RBS
How to set up and fix common problems with the WinCloud MCP Server and the WinCloud Open API, and how to contact RBS.
Effective: 22 October 2026
Last updated: 22 October 2026
Choose the part you need:
WinCloud MCP Server: for hotel staff using WinCloud in an AI assistant such as ChatGPT or Codex.
WinCloud Open API: for developers calling the WinCloud Open API directly.

WinCloud MCP Server#

Ask an AI assistant questions about your hotel, such as bookings, rates and room status, and get answers from your live WinCloud data.

Before you start#

Your WinCloud sign-in: Property ID, username and password. Your Property ID covers your hotels, which WinCloud calls locations.- An AI assistant: the Codex app, or a ChatGPT plan that lets you use plugins.

Set it up#

Choose your assistant.
ChatGPT / Codex
Claude
ChatGPT and Codex are both from OpenAI and share one plugin directory, so you find and install WinCloud the same way in each. The screenshots below are from the Codex app; where ChatGPT differs, the step says so.
1
Open Plugins
In the Codex app, select the plugins icon in the left sidebar. In ChatGPT, go to chatgpt.com/plugins.
The Codex app home screen
2
Find WinCloud
Find WinCloud in the list of plugins.
The Plugins page in Codex, with WinCloud in the list
3
Install the WinCloud plugin
Select WinCloud, then Install plugin. In ChatGPT, select the plus button.
The WinCloud plugin page, with the Install plugin button
4
Sign in to WinCloud
Your browser opens the Sign in to WinCloud page. Enter your Property ID, username and password, then select Sign in.
The Sign in to WinCloud page, with Property ID, Username and Password fields
5
Allow access
Under Locations it can use, keep All locations or choose the hotels the assistant can use. Check the list under It will be able to, then select Allow. Select Deny to cancel.
If the page warns that the app "has not been checked by RBS", continue only if you started this connection yourself.
The Allow access page, with locations, permissions and the Allow and Deny buttons
6
Pick WinCloud in a chat
Start a new chat. In Codex, select + and choose WinCloud under Plugins. In ChatGPT, switch from Chat to Work, type @ and select WinCloud. Then type your question.
Choosing WinCloud under Plugins in a new Codex chat
7
Read the answer
The assistant answers using your WinCloud data. You can ask follow-up questions in the same chat, or ask about another hotel by naming it.
Codex listing the latest bookings at a hotel
Codex answering how many rooms are vacant and occupied, and listing Deluxe room types
Codex listing a guest's checked-out stays

Questions to try#

Replace Grand Hotel with your own hotel's name.
"Find bookings made this month at Grand Hotel."
"How many rooms are vacant and occupied right now at Grand Hotel?"
"List the room types at Grand Hotel whose name includes Deluxe."
"What are the room tariffs for December at Grand Hotel?"
TIP
Keep your assistant's approval setting on (Ask for approval in Codex), so you see each request before it runs.

Common problems#

ProblemWhat to do
I cannot find WinCloud in the plugin listContact RBS Support. WinCloud may not be available to your account yet
The sign-in page shows an errorCheck your Property ID, username and password, then try again
The assistant says "You don't have access to company …"Your sign-in does not cover that hotel. Sign in again and choose it under Locations it can use. If it is not listed there, ask your RBS administrator for access
The assistant says it cannot answer questions about an area, for example ratesYour sign-in does not include that permission. Ask your RBS administrator to add it, then sign in again
The assistant does not use WinCloud to answerPick WinCloud in the chat, as in Pick WinCloud in a chat above, or mention WinCloud in your question
The assistant asks you to sign in againYour sign-in has expired. Sign in and allow access again
The assistant says "The request could not be completed"Wait a minute and try again. If it keeps happening, contact RBS Support
The assistant says "The WinCloud connection is not set up correctly"Contact RBS Support

WinCloud Open API#

For developers calling the WinCloud Open API directly.

Check these first#

401 Unauthorized: your token has expired or is invalid. Get a new token and try once more. See Authentication.
403 Forbidden: your credentials lack the permission for that endpoint. Ask your RBS administrator. See Permissions.
404 Not Found: the record does not exist, or it belongs to another customer.
429 Too Many Requests: you asked for tokens too often. Wait, then reuse the token you already have.
Every status code is explained on General.

What to include in your email#

The HTTP status and the errorCode or error_code
The environment (UAT or production) and the full URL you called
The date and time of the request, with your time zone
Your Client ID, but never your client secret

Contact and grievance officer#

Grievance: RBS Support
Email: support@rbsgo.com
In the subject, write WinCloud MCP Server or WinCloud Open API, then describe the problem in a few lines.
DANGER
Never send passwords, client secrets, guest personal details or payment card details, in an email, a screenshot or a chat message. Describe the problem in general terms instead.

© 2026 RBS (Winsar Infosoft Private Limited). All rights reserved.
Modified at 2026-10-22 11:01:25
Previous
Terms of Service
Next
Search Guests
Built with