Cloudbeds API (v1.2)

Welcome to the documentation for Cloudbeds API Version v1.2! If you are looking to learn how to use the Cloudbeds API to access guest information, reservations, or similar data for your Cloudbeds customers, then you've come to the right place.

In this document you will find all the API methods we provide along with explanations for parameters and response examples.

If you have questions about different implementation steps (e.g. how to implement OAuth 2.0), please refer to our Integrations Portal.

Be sure to subscribe to the monthly Cloudbeds API announcement mailing list to receive information on new additions and improvements to the Cloudbeds API and related developer tools.

Endpoint: https://api.cloudbeds.com/api/v1.2/{method}

HTTPS: Our API requires HTTPS. We'll respond with an appropriate error if you're not using it.

Request Format: HTTP GET, POST and PUT (Content-Type: application/x-www-form-urlencoded)

Response Format: JSON

Response Header: X-Request-ID is added to response headers in all calls to help accelerate support and troubleshooting.

Run in Postman use this link to access our Public collection in Postman.

Download OpenAPI description
Languages
Servers
Mock server
https://tbg-api-docs.vacatia.com/_mock/cloudbeds/
https://api.cloudbeds.com/api/v1.2/

Authentication

Operations

Adjustment

Operations

AllotmentBlocks

Operations

AppSettings

Operations

deleteAppPropertySettings

Request

Bodyapplication/x-www-form-urlencoded
propertyIDstring

Key

keystring

Key

curl -i -X POST \
  https://tbg-api-docs.vacatia.com/_mock/cloudbeds/deleteAppPropertySettings \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d propertyID=string \
  -d key=string

Responses

200 Response

Bodyapplication/json
successboolean

Success

messagestring

Response message

Response
application/json
{ "success": true, "message": "string" }

getAppPropertySettings

Request

Returns the app property settings

Query
propertyIDstringrequired

Property ID

keystring

Key

curl -i -X GET \
  'https://tbg-api-docs.vacatia.com/_mock/cloudbeds/getAppPropertySettings?key=string&propertyID=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

200 Response

Bodyapplication/json
successboolean

Success

dataArray of objects

Data

Response
application/json
{ "success": true, "data": [ { … } ] }

postAppPropertySettings

Request

Bodyapplication/x-www-form-urlencoded
propertyIDstring

Property ID

appClientIDstring

Application Client ID

keystring

Key

valuestring

Value

curl -i -X POST \
  https://tbg-api-docs.vacatia.com/_mock/cloudbeds/postAppPropertySettings \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d propertyID=string \
  -d appClientID=string \
  -d key=string \
  -d value=string

Responses

200 Response

Bodyapplication/json
successboolean

Success

dataobject

Data

Response
application/json
{ "success": true, "data": { "id": "string", "key": "string", "value": "string" } }

putAppPropertySettings

Request

Bodyapplication/x-www-form-urlencoded
propertyIDstring

Property ID

keystring

Key

valuestring

Value

curl -i -X POST \
  https://tbg-api-docs.vacatia.com/_mock/cloudbeds/putAppPropertySettings \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d propertyID=string \
  -d key=string \
  -d value=string

Responses

200 Response

Bodyapplication/json
successboolean

Success

dataobject

Data

Response
application/json
{ "success": true, "data": { "id": "string", "key": "string", "value": "string" } }

Currency

Operations

CustomFields

Operations

Dashboard

Operations

Emails

Operations

Groups

Operations

Guest

Operations

Hotel

Operations

HouseAccount

Operations

Housekeeping

Operations

Integration

Operations

Invoices

Operations

Item

Operations

Package

Operations

Payment

Operations

Rate

Operations

Reservation

Operations

Room

Operations

Taxes and Fees

Operations

User

Operations