Hotels Cloudbeds Cloudbeds API

Name: Cloudbeds API
Brand: Cloudbeds API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceOrder ManagementapiKey,oauth2115 EndpointsREST

For Agents

Manage reservations, guests, rooms, rates, payments, and housekeeping for hotels and short-stay properties on Cloudbeds.

Install Jentic One Beta

Connect the Cloudbeds API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Cloudbeds API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Cloudbeds API.

Create, retrieve, and modify reservations across rooms and rate plans

Manage guest profiles, custom fields, and tax exemptions

Adjust room rates and allotment blocks for groups and OTA channels

GET STARTED

Start building with Cloudbeds API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Cloudbeds API, keeping it validated and agent-ready. The Cloudbeds API is the property management system surface for hotels, hostels, and B&Bs — reservations, guests, rooms, rates, allotments, taxes, payments, housekeeping, and email templates live behind 115 endpoints. It supports both API key and OAuth 2.0 authentication, so partner integrations and single-property keys both work. Useful for booking automation, channel reconciliation, and AI hospitality assistants.

Use Cases

Patterns agents use Cloudbeds API for, with concrete tasks.

★ Front Desk Automation

Automate front-desk workflows by reading arrivals, posting payments, and updating housekeeping status from a single agent. The agent calls the dashboard endpoints to surface arrivals, posts charges via the payment endpoints, and flips room status in housekeeping when guests check out. Reduces manual click-through during shift changes.

Pull today's arrivals from the dashboard, then update housekeeping status for departing rooms via the housekeeping endpoints.

OTA Channel Reconciliation

Reconcile reservations and rates between Cloudbeds and external OTA channels. The agent reads reservations and rate plans, compares against the OTA extranet, and flags mismatches for review. Helps revenue managers catch parity violations before they cost bookings.

Fetch all rates for the next 30 days from Cloudbeds and diff against the latest OTA pull, returning any deltas.

Group Block Management

Manage corporate and event group blocks via the AllotmentBlocks endpoints. The agent calls createAllotmentBlock to reserve room inventory for a group, updates the block as bookings come in, and adds notes via the AllotmentBlockNotes endpoints for the front-desk team. Replaces spreadsheet tracking.

Create an allotment block for 25 rooms over conference dates and attach a note with the group contract reference.

Guest Email Scheduling

Schedule pre-arrival, in-stay, and post-stay emails from Cloudbeds. The agent calls postEmailTemplate to register the message body and postEmailSchedule to attach a trigger (e.g., 24 hours before arrival). Keeps guest communications consistent across properties without separate ESP wiring.

Create a pre-arrival email template and schedule it to send 24 hours before each reservation's check-in date.

AI Hotel Operations Agent via Jentic

Expose Cloudbeds' 115 endpoints to an AI hospitality agent through Jentic so it can handle reservations, payments, and housekeeping without juggling auth schemes or browsing docs. Jentic stores the API key or OAuth tokens in the MAXsystem vault and surfaces operations by intent search.

Search Jentic for 'list today's arrivals in Cloudbeds', load the schema, and execute against the property to return arriving reservations.

Key Endpoints

115 endpoints — jentic publishes the only available openapi specification for cloudbeds api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/access_token

Exchange OAuth code for access token

GET

/getDashboard

Pull property KPIs

GET

/getAllotmentBlocks

List group allotment blocks

POST

/createAllotmentBlock

Create a group allotment block

POST

/postAdjustment

Post a folio adjustment

POST

/postEmailTemplate

Create a guest email template

POST

/postEmailSchedule

Schedule a guest email

POST

/access_token

Exchange OAuth code for access token

GET

/getDashboard

Pull property KPIs

GET

/getAllotmentBlocks

List group allotment blocks

POST

/createAllotmentBlock

Create a group allotment block

POST

/postAdjustment

Post a folio adjustment

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Cloudbeds API keys and OAuth 2.0 tokens are stored encrypted in the Jentic vault (MAXsystem). Refresh tokens rotate automatically — agents never see the raw credential.

Intent-based discovery

Across 115 endpoints, agents use Jentic intent search (e.g., 'create reservation in Cloudbeds') to find and execute the right operation without reading 115 doc pages.

Time to first call

Direct integration: 3-5 days across auth schemes, reservation modeling, and folio handling. Through Jentic: under an hour for the first reservation call.

FAQs

Specific to using Cloudbeds API through Jentic.

Why is there no official OpenAPI spec for Cloudbeds API?

Cloudbeds publishes API documentation but not a maintained OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Cloudbeds API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Cloudbeds API use?

Two options: an API key passed in a request header for single-property integrations, or OAuth 2.0 for multi-property partner apps. The /access_token endpoint exchanges an authorization code for tokens. Jentic stores credentials in the MAXsystem vault.

Can I create reservations with the Cloudbeds API?

Yes. The Reservation resource exposes create, read, modify, and cancel operations. You attach guests, room types, and rate plans to the reservation, and Cloudbeds maintains the folio that links payments and adjustments back to it.

What are the rate limits for the Cloudbeds API?

Cloudbeds enforces per-property and per-app rate limits that scale with partnership tier. Honor 429 responses, batch reads where possible, and use webhooks for state changes rather than polling /getDashboard or reservation lists in tight loops.

How do I post a payment to a reservation with the Cloudbeds API through Jentic?

Run pip install jentic, search for 'post payment to Cloudbeds reservation', load the appropriate Payment schema, and execute with the reservation id and amount. Jentic handles the auth header automatically.

Can I manage group allotments with the Cloudbeds API?

Yes. Use createAllotmentBlock to set aside room inventory, getAllotmentBlocks to list active blocks, updateAllotmentBlock to adjust counts, and the AllotmentBlockNotes endpoints to attach group contract context.

Hotels Cloudbeds Cloudbeds API

Connect the Cloudbeds API to your agent

Capabilities

Start building with Cloudbeds API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs