Register as a technology partner in the Cloudbeds developer portal and configure a redirect URI; Cloudbeds delivers an authorization_code to that URI when a property connects your app
Exchange the authorization_code for an API key; Cloudbeds API keys begin with the prefix cbat_ and are long-lived but expire if unused for 30 days
Include the API key in all requests as the x-api-key header or as a Bearer token in the Authorization header
Call the patchRate endpoint to update nightly rates and restrictions; note that the endpoint is asynchronous and returns a jobReferenceID for status tracking rather than immediate confirmation
Restrict rate updates to non-derived rate plans only; requests to update a derived rate plan return an error
Batch rate updates within the limit of 30 intervals per call and poll the job status using the returned jobReferenceID to confirm successful processing
Known gotchas
API keys expire after 30 days of inactivity; properties that have not had any API activity within that window will require the property to re-authorize the app connection
The patchRate endpoint is asynchronous; code that assumes synchronous confirmation and immediately queries rates back will see stale values because updates are queued
Derived rates cannot have their base rate overridden via API; attempting to do so returns an error, and the derived rate continues to compute from its parent plan
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp