Deze pagina is nog niet vertaald, dus je leest de Engelse versie.
Hotel features API
The ChatBeds app's own endpoints for payments in WhatsApp and phone bookings, negotiation, night mode and phone lines, and the AI manager. Called with a signed-in person's login, inside their role.
These pages describe endpoints the ChatBeds app itself uses for some newer features. Use them to script a hotel's own setup, or to build an internal tool for a hotel group. For a channel, an OTA or an app used by many hotels, use the partner API instead.
Base URL
https://app.chatbeds.app/api/v1All requests and responses are JSON over HTTPS.
Authentication
Send the Firebase ID token of a person signed in to ChatBeds:
Authorization: Bearer <Firebase ID token>- The token is the one the ChatBeds app gets when the person signs in. It lasts an hour; refresh it with the Firebase SDK.
- A partner key (
cbk_...) or an app token (cbat_...) is not accepted here: the answer is401. - The call can do only what the person's role allows. Each endpoint below names the permission it needs. Without it the answer is
403, with a sentence that names the permission. - Most endpoints take
property_idas a query parameter (a body field forPUT /finance/chat-payment). A property of another account answers404Property not found.
Not versioned like the partner API
These endpoints follow the app. Fields can be added at any time. Ignore fields you don't know.
Errors
Errors are JSON with a detail field, in the language of the request's Accept-Language header when ChatBeds has it.
| Status | When |
|---|---|
400 | A value is out of range or doesn't fit the rest of the settings. detail says which |
401 | No token, or one that is wrong or expired |
403 | The person's role lacks the permission |
404 | The property, negotiation, line, call or question isn't this account's |
409 | The action conflicts with the current state, for example an offer that has expired |
422 | A field is missing or of the wrong type. detail is a list of field problems |
In this section
Payments in WhatsApp and phone bookings
What a guest pays when booking in the chat or on a call, and the Pay now button.
Negotiation
The hotel's limits for private offers, the negotiations, and offers made at the desk.
Night mode and phone lines
Ana runs the desk at night; phone calls to Ana on WhatsApp, Twilio, Telnyx or SIP.
AI manager
The jobs it does every day, its limits, and the price questions waiting for a yes.
Bouw je iets?
Agent API and MCP
Let an AI agent work a hotel on ChatBeds as a member of its team, over REST or MCP, with the hotel's rules, previews, approvals and undo. Sign in with an agent key or OAuth.
Payments in WhatsApp and phone bookings
Choose what a guest pays when Ana books a room on WhatsApp or a phone call, an advance with a Pay now button or pay at the hotel, and how the 2-hour hold, the reminder and the release work.