Google Mail Search Messages action is used to search emails in Gmail based on specific criteria. The user can retrieve emails filtered using Gmail's search syntax (e.g., from:, subject:, before:, after:) by using the query parameter. This action can be used for inbox management, reporting, customer communication tracking, and automated workflows.

Technical Specifications

• Function: Returns a list of emails by searching the Gmail account.
• Parameters:
  
  • settings (Object – required): Connection settings for Gmail integration.
  • query (String – required): Gmail search criteria.
    
    • Examples:
      
      • “from:abc@gmail.com” → Specific sender.
      • “subject:Report” → Emails with the subject ‘Report’.
      • “after:2025/09/01 before:2025/09/17” → Specific date range.
  • pageSize (Int32 – optional): Determines how many emails to return.
• Result: Many → Returns the ID and summary information of matching emails.
• Value Binding:
  
  • Parameters can be entered as fixed.
  • Dynamic values can be bound with the Symbol Picker (e.g., user search box → query).
• Web & Mobile Support: Works on both web and mobile applications.

Google Mail Search Messages Application Steps

1. Adding an Action

• Open the screen to be searched in your Kuika project.
• Add UI Design → + ADD ACTION → Google → Google Mail Search Messages.

2. Configuring Parameters

• settings: Select the settings for Gmail integration.
• query:
  
  • Fixed value → “from:info@firma.com”.
  • Dynamic value → Link the phrase the user types in the search box here.
• pageSize: Determines the number of results (e.g., 20).

Use Case: “Searching for Report Emails in the Inbox”

In a business application, the user wants to search for all emails titled “Report” via Gmail.

Steps:

1. The user types ‘Report’ in the search box.
2. query = “subject:Report” is sent to the action.
3. Google Mail Search Messages runs and returns the relevant emails.
4. The results are displayed on the screen using the Table element.

Google Mail Search Messages Advanced Customizations

• Dynamic Search: The date range or sender selected by the user → can be automatically added to the query parameter.
• Using the Results: The returned messageId values can be passed to the Google Mail Get Message Content or Batch action.
• Conditional Filtering: Additional workflows can be triggered based on email labels.

Technical Risks and Controls

• If the query is left blank, all emails in the Gmail inbox may be returned (performance decreases).
• A very high pageSize (e.g., 500+) may cause performance issues.
• Incorrectly written Gmail search operators may not return results.