Actions67
- Addon Actions
- Door Lock Actions
- Event Actions
- Guest Actions
- Housekeeping Actions
- Integration Event Actions
- Item Actions
- Market Segmentation Actions
- Payment Actions
- Property Actions
- Rate Actions
- Reservation Actions
- Room Actions
- Webhook Actions
Reservation → Create
AI-generatedSummary
Creates a new reservation in Cloudbeds.
Inputs
- authentication (required) — Authentication method – either Access Token or OAuth2.
- startDate (required) — Check‑in date for the reservation.
- endDate (required) — Check‑out date for the reservation.
- guestFirstName (required) — First name of the guest.
- guestLastName (required) — Last name of the guest.
- guestEmail (required) — Email address of the guest.
- guestCountry (required) — ISO 2‑character country code (e.g., MX, US, ES).
- guestZip (required) — ZIP/postal code of the guest.
- roomTypeId (required) — Room type ID to reserve (obtain via Get Room Types).
- roomQuantity (required) — Number of rooms to reserve (minimum 1).
- adults (required) — Number of adults (minimum 1).
- children (required) — Number of children (minimum 0).
- paymentMethod (required) — Payment method – Cash, Credit Card, E‑Banking, or PayPal.
- estimatedArrivalTime — Estimated arrival time in 24‑hour format (e.g., 14:00).
- guestGender — Gender of the guest – Female, Male, or Not Specified.
- guestPhone — Phone number of the guest.
- promoCode — Promotional code for specials and packages.
- sendEmailConfirmation — Whether to send a confirmation email to the guest (default: true).
- sourceID — Third‑party source ID for this reservation.
- thirdPartyIdentifier — Identifier from the booking channel.
Output shape
object
Returns the reservation object created by the Cloudbeds API, typically containing reservation ID and details.
Examples
Example 1: Create a standard reservation.
Set authentication, dates, guest info, room type ID = 123, quantity = 1, adults = 2, children = 0, paymentMethod = Credit Card.