Search Messages

The Search Messages action searches a Gmail mailbox and returns matching message IDs. Its query uses the same operators as Gmail’s search bar.

Inputs

Input	Type	Required	Description
Third-party account	Google account	Yes	Account whose mailbox is searched.
Query	String	Yes	Gmail search query. Whitespace-only text is ignored.
Max Results	Number	No	Maximum IDs to return, from `1` to `100`. Defaults to `10`.
Include Spam & Trash	Boolean	No	Whether Spam and Trash are included. Defaults to `false`.
After Date	Date	No	Only messages after this calendar date.
Before Date	Date	No	Only messages before this calendar date.

The date inputs are appended to the Gmail query using after:YYYY/M/D and before:YYYY/M/D. You can combine them with operators in Query:

from:billing@example.com has:attachment

Outputs

Output	Type	Description
Message IDs	List of strings	Gmail IDs for the matching messages.

This action returns identifiers only. Repeat over Message IDs and use Get Message by ID when you need subjects, bodies, or attachments.

Example: process recent invoices

Gmail: Search Messages
  Query = subject:invoice has:attachment
  After Date = start of month
  → Repeat over Message IDs
  → Gmail: Get Message by ID

Troubleshooting

Expected messages are missing

Test the same query in Gmail, check the date boundaries, and enable Include Spam & Trash if those folders should be searched.

Only some matches are returned

Increase Max Results up to 100. The action returns a single result page and does not expose pagination.

Send EmailSend a plain-text or HTML email from a connected Gmail account.

Overview

Fundamentals

Web, Files & Data

AI

Scraping & Rendering

Google Workspace

Email, CRM & Scheduling

Databases & Tables

Microsoft

Inputs

Outputs

Example: process recent invoices

Troubleshooting

​Inputs

​Outputs

​Example: process recent invoices

​Troubleshooting

Inputs

Outputs

Example: process recent invoices

Troubleshooting