Cloudbeds API
Cloudbeds is a unified hospitality management platform combining PMS, channel manager, booking engine, payments, and revenue marketing for 26,000+ properties across 150 countries. An unofficial API lets you programmatically pull reservations, guests, rooms, rates, availability, and payment transactions—and push updates like new bookings, room assignments, rate changes, and housekeeping status back into Cloudbeds.
What is Cloudbeds?
Cloudbeds is a unified hospitality management platform that combines operations, distribution, guest experience, and revenue marketing tools—enhanced by AI—for lodging businesses. Properties use Cloudbeds to run front-desk operations, distribute inventory across 300+ OTAs and wholesalers, take commission-free direct bookings, process payments, manage guest communications and digital check-in, and make data-driven pricing decisions. The platform serves 26,000+ properties across 150 countries.
Core product areas include:
- Operations (Property Management System, Payments, Marketplace with 450+ integrations, Open API)
- Distribution (commission-free Booking Engine, Channel Manager, direct connections to 300+ OTAs and wholesalers)
- Guest Experience (AI chatbot, unified messaging inbox, guest portal, digital check-in, self-service kiosk, task and ticket management)
- Revenue Marketing (Digital Marketing, Reputation Management, Website builder, Guest Marketing CRM, Revenue Intelligence powered by Signals AI)
Common data entities:
- Reservations, Bookings, Stay Dates, Sources/Channels
- Guests, Profiles, Contact Details, Messages
- Rooms, Room Types, Availability, Housekeeping Status
- Rates, Rate Plans, Restrictions, Inventory Allocations
- Payments, Transactions, Folios, Invoices, Adjustments
The Cloudbeds Integration Challenge
Properties run mission-critical front-desk and distribution workflows on Cloudbeds daily, but turning portal-driven operations into reliable API-driven automation is non-trivial:
- Partner program gates: API and OAuth client access flows through Cloudbeds' partner program, which can require approval and credentialing before production use
- Strict rate limits: Property accounts are capped around 5 requests/second and tech partners around 10/second—exceeding limits can block the IP and disrupt the property's front-desk account
- Multi-property complexity: Group accounts span many properties with their own room types, rate plans, and inventory—generic integrations break across portfolios
- Webhook-first reservation flow: Cloudbeds recommends subscribing to webhooks for new and changed reservations, with retries capped at five attempts—missed events require reconciliation logic
- Availability and rate sync sensitivity: Channel-manager pushes for rates, restrictions, and inventory must be precise to avoid overbookings and rate parity issues
- Payments and folio handling: Transactions, folios, and adjustments require careful idempotency and reconciliation against the property's books
How Supergood Creates Cloudbeds APIs
Supergood reverse-engineers authenticated flows and Cloudbeds' OAuth 2.0 and API-key surfaces to deliver a resilient API layer for your property or group account—handling the partner credentialing, rate limits, and webhook lifecycle for you.
- Handles OAuth 2.0 and API-key authentication with secure token storage and refresh, including the non-invalidating refresh-token flow
- Respects per-account rate limits with adaptive throttling and backoff to avoid IP blocks
- Manages webhook subscriptions and reconciles missed events so reservation state stays accurate
- Normalizes responses across reservations, guests, rooms, rates, and payments so you integrate once across single and multi-property accounts
Use Cloudbeds with AI agents: Cloudbeds MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your property or group account, modules, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Cloudbeds adapter tailored to your account configuration, rate limits, and webhook setup.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Cloudbeds evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Cloudbeds property or group account using OAuth 2.0 or an API key and obtain a session token for downstream calls.
Reservations
/reservationsList reservations with filters for property, status, stay dates, source/channel, and guest, including rate details.
Reservations
/create_reservationCreate a new reservation against available inventory with guest, room type, rate plan, and stay-date details.
Guests
/guestsRetrieve guest profiles, contact details, and stay history with search and pagination filters.
Inventory
/availabilityPull room availability, rates, and restrictions by room type and date range across the channel manager.
Inventory
/update_ratesPush rate, restriction, and inventory updates for room types and rate plans to keep distribution channels in sync.
Payments
/transactionsList payments, folio transactions, and adjustments for reconciliation against the property's books.
Use Cases
Sync reservations and guest data into your warehouse
- Pull reservations, stay dates, and source/channel data across single and multi-property accounts - Stream new-reservation and reservation-change webhook events to downstream BI and CRM tools - Reconcile guest profiles and contact details for a unified guest 360
Automate rate and availability distribution
- Push rates, restrictions, and inventory to the channel manager without portal clicks - Pull availability by room type and date range for revenue and pricing tools - Detect parity and overbooking risks across 300+ connected OTAs
Reconcile payments and folios
- Sync payments, folio transactions, and adjustments into accounting and AR systems - Match deposits and charges against reservations and guest folios - Surface chargebacks and refunds to finance workflows
Streamline front-desk and housekeeping operations
- Pull room and housekeeping status to drive operational dashboards - Trigger digital check-in and room-assignment workflows from external systems - Route tasks and tickets to staff without manual portal entry
Technical Specifications
Authentication
OAuth 2.0 and API-key authentication handled in a managed session, including non-invalidating refresh-token rotation
Connectivity
Cloudbeds Open API surfaces plus authenticated flows for property and group accounts
Response format
Normalized JSON across reservations, guests, rooms, rates, and payment objects
Rate limits
Adaptive throttling tuned to per-account limits (~5 req/s for properties, ~10 req/s for tech partners) to avoid IP blocks
Session management
Automatic token refresh, credential rotation, and OAuth client lifecycle handling
Data freshness
Near real-time reservation, availability, and payment data with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Managed webhook subscriptions for reservation created/changed events with reconciliation for missed deliveries (5-attempt retry)
Latency
Sub-second reads on cached entities; multi-second writes when posting reservations and rate updates
Throughput
Horizontally scaled workers sized to multi-property reservation and distribution volume
Reliability
Retry, backoff, and idempotency keys for reservations, rate pushes, and payment transactions
Adaptation
Continuous monitoring of Cloudbeds API releases, webhook changes, and account configuration drift
Frequently asked questions
Supergood works with your existing Cloudbeds property or group account and authenticated sessions. Where the partner program and OAuth credentialing are required, we handle the setup so you can integrate without standing up your own approved client.
We apply adaptive throttling and backoff tuned to per-account limits—roughly 5 requests/second for properties and 10/second for tech partners—so calls never trip the IP block that can disrupt your front-desk account.
Yes. Supergood normalizes data across properties in a group account, preserving each property's room types, rate plans, and inventory so you integrate once across the whole portfolio.
We manage Cloudbeds webhook subscriptions for reservation created and changed events and reconcile any missed deliveries—since Cloudbeds retries only up to five times—so your reservation state stays accurate.
Yes. You can push rate, restriction, and inventory updates by room type and rate plan, and pull availability for pricing tools, keeping your 300+ connected OTAs in sync.