Requirements
Connecting Cloudbeds takes an active account plus OAuth client credentials, granted by signing in with your account — no other setup is required.[3]
Get your Cloudbeds credentials
Cloudbeds
You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.
- Client IDtextRequired
- Client SecretpasswordRequired
Cloudbeds API Key
- API KeytextRequired
You can generate API Key from
[1]Dashboard -> Apps & Marketplace -> API Credentials.
Cloudbeds V3
You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.
- Client IDtextRequired
- Client SecretpasswordRequired
Connect Cloudbeds in WEXTL
- Log in to your WEXTL account, add the Cloudbeds node module to your workflow, and click Create new credential.Instant triggers use webhooks — click Create a webhook first when adding one, then create the credential.
- Optional: In the Credential name field, enter a name for the credential.
- Enter the authentication credentials you copied from your Cloudbeds account, or follow the on-screen instructions to create the credential.
- If prompted, authenticate your account and confirm access.
- If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Notes
Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →
Cloudbeds node modules
The list below is a reference of every Cloudbeds node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.
Expand any Cloudbeds node module below to see exactly what it takes in, what it returns, and what connection it needs.
Watch EventsTrigger
| Field | Type |
|---|---|
| Version | text |
| Timestamp | number |
| Event | text |
| Property ID | number |
| Property ID Str | number |
| Property ID | number |
| Property ID Str | number |
| Reservation ID | number |
| Start Date | text |
| Room ID | text |
| Status | text |
| Reservation ID | number |
| Client ID | number |
| Old State | text |
| New State | text |
| Queue Task ID | number |
| Queue Task ID Str | number |
| End Date | text |
| Room Block ID | text |
| Room Block Type | text |
Watch GuestsTrigger
| Field | Type |
|---|---|
| Guest ID | number |
| First Name | text |
| Last Name | text |
| Gender | text |
| text | |
| Phone | text |
| Cell Phone | text |
| Country | text |
| Address | text |
| Address 2 | text |
| City | text |
| Zip | text |
| State | text |
| Birth Date | text |
| Document Type | text |
| Document Number | text |
| Document Issue Date | text |
| Document Issuing Country | text |
| Document Expiration Date | text |
| Custom Fields | array |
Watch ReservationsTrigger
| Field | Type |
|---|---|
| Property ID | text |
| Reservation ID | text |
| Date Created | text |
| Date Modified | text |
| Status | text |
| Guest ID | text |
| Guest Name | text |
| Start Date | text |
| End Date | text |
| Adults | number |
| Children | number |
| Balance | number |
| Source Name | text |
| Source ID | text |
| Third Party Identifier | text |
| Guest List | object |
| 1 | object |
Get a GuestAction
| Field | Type |
|---|---|
| Property ID | number |
Get Guest ByRequired | choice |
| Field | Type |
|---|---|
| Guest ID | number |
| First Name | text |
| Last Name | text |
| Gender | text |
| text | |
| Phone | text |
| Cell Phone | text |
| Country | text |
| Address | text |
| Address 2 | text |
| City | text |
| Zip | text |
| State | text |
| Birth Date | text |
| Document Type | text |
| Document Number | text |
| Document Issue Date | text |
| Document Issuing Country | text |
| Document Expiration Date | text |
| Custom Fields | array |
List Guest NotesSearch
List ItemsSearch
| Field | Type |
|---|---|
| Property ID | text |
| Item Category ID | choice |
| Limit | number |
| Field | Type |
|---|---|
| Item ID | text |
| Item type | text |
| Sku | text |
| Item code | text |
| Name | text |
| Category ID | text |
| Category name | text |
| Description | text |
| Price | number |
| Stock inventory | boolean |
| Item quantity | number |
| Reorder threshold | number |
| Reorder needed | boolean |
| Stop sell | number |
| Stop sell met | boolean |
| Taxes | array |
| Total taxes | number |
| Fees | array |
| Total fees | number |
| Price without fees and taxes | number |
List PackagesSearch
List Reservation NotesSearch
List ReservationsSearch
| Field | Type |
|---|---|
| Property ID | choice |
| Reservation Status | choice |
| Results From Date | date |
| Results To Date | date |
| Modified From Date | date |
| Modified To Date | date |
| Check-in From Date | date |
| Check-in To Date | date |
| Check-out From Date | date |
| Check-out To Date | date |
| Room ID | text |
| Room Name | text |
| Include Guests Details | boolean |
| Include Custom Fields | boolean |
| Source ID | text |
| Source Reservation ID | text |
| Rate Plan ID | text |
| First Name | text |
| Last Name | text |
| Sort By Most Recent | boolean |
| Field | Type |
|---|---|
| Property ID | text |
| Reservation ID | text |
| Date Created | text |
| Date Modified | text |
| Status | text |
| Guest ID | text |
| Guest Name | text |
| Start Date | text |
| End Date | text |
| Adults | number |
| Children | number |
| Balance | number |
| Source Name | text |
| Source ID | text |
| Third Party Identifier | text |
| Guest List | object |
| 1 | object |
List RoomsSearch
List UsersSearch
| Field | Type |
|---|---|
| Property IDs | choice |
| Limit | number |
Search GuestsSearch
| Field | Type |
|---|---|
| Property IDs | array |
| Property ID | number |
| Results From Date | date |
| Results To Date | date |
| Check In From Date | date |
| Check In To Date | date |
| Check In From Date | date |
| Check Out To Date | date |
| Status | choice |
| Sort By | choice |
| Include Guest Info | boolean |
| Exclude Secondary Guests | boolean |
| Limit | number |
| Field | Type |
|---|---|
| Reservation ID | text |
| Guest Name | text |
| Guest Email | text |
| Guest ID | number |
| Date Created | text |
| Date Modified | text |
| Is Main Guest | boolean |
| Is Anonymized | boolean |
| Guest Opt In | boolean |
| Is Merged | boolean |
| New Guest ID | number |
Add a Guest to a RoomAction
Create a Guest NoteAction
Create a PaymentAction
Create a ReservationAction
| Field | Type |
|---|---|
Start DateRequired | date |
End DateRequired | date |
Guest First NameRequired | text |
Guest Last NameRequired | text |
Guest EmailRequired | |
Guest CountryRequired | text |
Guest ZipRequired | text |
RoomsRequired | array |
Room Type IDRequired | choice |
QuantityRequired | number |
| Room ID | text |
| Room Rate ID | text |
AdultsRequired | array |
Room Type IDRequired | choice |
QuantityRequired | number |
| Room ID | text |
ChildrenRequired | array |
Room Type IDRequired | choice |
QuantityRequired | number |
| Room ID | text |
Payment MethodRequired | choice |
| Property ID | number |
| Source ID | number |
| Third Party Identifier | text |
| Guest Gender | choice |
| Guest Phone | text |
| Estimated Arrival Time | time |
| Custom Fields | array |
Field NameRequired | choice |
Field ValueRequired | text |
| Promo Code | text |
| Allotment Block Code | text |
| Field | Type |
|---|---|
| Success | boolean |
| Reservation ID | text |
| Status | text |
| Guest ID | text |
| Guest First Name | text |
| Guest Last Name | text |
| Guest Gender | text |
| Guest Email | text |
| Start Date | text |
| End Date | text |
| Date Created | text |
| Grand Total | number |
| Unassigned | array |
Create a Reservation NoteAction
Create a Room BlockAction
| Field | Type |
|---|---|
Room Block TypeRequired | choice |
Room Block ReasonRequired | text |
Room Block Start DateRequired | date |
Room Block End DateRequired | date |
Property IDRequired | choice |
| First Name | text |
| Last Name | text |
| Length of Hold in Hours | number |
| Email Address | |
| Phone Number | text |
| Field | Type |
|---|---|
| Success | boolean |
| Property ID | text |
| Room block ID | text |
| Room block type | text |
| Room block reason | text |
| Start date | text |
| End date | text |
| Rooms | array |
| Message | text |
Create a Room Check-InAction
Create a Room Check-OutAction
Delete a Guest NoteAction
Delete a Reservation NoteAction
Make an API Calluniversal
Update a GuestAction
| Field | Type |
|---|---|
Guest IDRequired | choice |
| Property ID | text |
| Guest First Name | text |
| Guest Last Name | text |
| Guest Gender | choice |
| Guest Email | text |
| Guest Phone | text |
| Guest Cell Phone | text |
| Guest Address 1 | text |
| Guest Address 2 | text |
| Guest City | text |
| Guest Country | text |
| Guest State | text |
| Guest Zip | text |
| Guest Birth Date | date |
| Guest Document Type | choice |
| Guest Custom Fields | array |
Custom Field NameRequired | text |
Custom Field ValueRequired | text |
| Guest Company Name | text |
| Guest Company Tax ID | text |
| Guest Tax ID | text |
Update a Guest NoteAction
Update a ReservationAction
| Field | Type |
|---|---|
Reservation IDRequired | choice |
| Property ID | number |
| Status | choice |
| Estimated Arrival Time | time |
| Checkout Date | date |
| Custom Fields | array |
Field NameRequired | choice |
Field ValueRequired | text |
| Rooms | array |
| Sub Reservation ID | text |
Room Type IDRequired | choice |
Check in DateRequired | date |
Check out DateRequired | date |
AdultsRequired | number |
ChildrenRequired | number |
| Rate ID | text |
| Date Created | date |
| Field | Type |
|---|---|
| Property ID | number |
| Guest Name | text |
| Guest Email | text |
| Is Anonymized | boolean |
| Guest List | object |
| 6870881174818816 | object |
| Reservation ID | text |
| Date Created | text |
| Date Modified | text |
| Estimated Arrival Time | text |
| Source | text |
| Source ID | text |
| Third Party Identifier | text |
| Status | text |
| Total | number |
| Balance | number |
| Balance Detailed | object |
| Suggested Deposit | text |
| Sub Total | number |
| Additional Items | number |
| Taxes Fees | number |
| Grand Total | number |
| Paid | number |
| Assigned | array |
| Unassigned | array |
| Cards On File | array |
| Custom Fields | array |
Update a Reservation NoteAction
Upload a Guest DocumentAction
Upload a Guest PhotoAction
Templates
Look for Cloudbeds templates in the WEXTL template library.
Browse templates →Explore alternative apps
- Anny Admin API[2]Online booking and scheduling platform for managing services, resources, timeslots, and customer appointments.
- BookeoOnline booking and appointment scheduling platform for tours, classes, and service businesses.
- AppointeddOnline booking and appointment scheduling for retail and service businesses.
- AviratoHotel property management and channel booking for rates, availability, and reservations.
- AddEventCalendar event sharing and add-to-calendar links for websites and campaigns.
References
- WEXTL® Cloudbeds Source Code connector implementation.
- Our users use cases and automations.
- Official API Documentation for Cloudbeds.
- WEXTL® visual workflow builder data.
Last updated: Jul 23, 2026 22:39
