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
Guest → Search
AI-generatedSummary
Search for guests in Cloudbeds matching a search query such as name, email, or phone number.
Inputs
- authentication — Select the authentication method to use: Access Token or OAuth2.
- query (required) — The search term used to match guest records (e.g., name, email, or phone number).
- returnAll — Whether to return all matching guest records or limit the number of returned results.
- limit — Maximum number of guest records to return when Return All is disabled (1 to 100).
Output shape
a list of items
Returns a list of matching guest objects.
Examples
Example 1: Search for a guest by email address
Query: 'guest@example.com', Return All: false, Limit: 10
Example 2: Find all guests matching a surname
Query: 'Smith', Return All: true