Gmail: Search Messages
Search the mailbox with Gmail's query syntax (e.g. 'is:unread from:boss@x.com newer_than:7d') and return matches as a DataTable (messageId, threadId, from, to, subject, date, snippet).
Overview
Gmail: Search Messages is a no-code automation step in the Gmail category of AutoFlowRPA. It performs its action in a single step when the workflow reaches it. You can configure 6 parameter(s) to control exactly how it behaves. It is one of 369 commands you can drag into a workflow in the visual builder — no scripting required.
What it does
Search the mailbox with Gmail's query syntax (e.g. 'is:unread from:boss@x.com newer_than:7d') and return matches as a DataTable (messageId, threadId, from, to, subject, date, snippet).
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| Connection name | variable | Required | gmail | Name of the connection created by 'Authorize Gmail'. |
| Search query (Gmail syntax) | string | Optional | Same syntax as the Gmail search box. Blank = all mail. Example: is:unread from:boss@example.com newer_than:7d Supports variables | |
| Label filter (optional) | string | Optional | Only messages with these labels (names or ids, comma separated). e.g. INBOX, IMPORTANT, or a custom label name. Example: INBOX Supports variables | |
| Include spam & trash | dropdownNo · Yes | Optional | No | |
| Max messages | number | Optional | 50 | |
| Store DataTable in | variable | Required | messages |
How to use Gmail: Search Messages
- 1
Open AutoFlowRPA and drag the Gmail: Search Messages command from the Gmail group onto the canvas.
- 2
Set its parameters in the side panel — Gmail: Search Messages has 6 configurable field(s).
- 3
Connect it into your workflow and press Run. Everything executes locally on your machine.
Frequently asked questions
What does the Gmail: Search Messages command do?
Search the mailbox with Gmail's query syntax (e.g. 'is:unread from:boss@x.com newer_than:7d') and return matches as a DataTable (messageId, threadId, from, to, subject, date, snippet).
Which group does the Gmail: Search Messages command belong to?
Gmail: Search Messages is part of the Gmail group. AutoFlowRPA ships with 369+ ready-made commands you can combine without code.
Does the Gmail: Search Messages command take any parameters?
Yes — Gmail: Search Messages has 6 configurable field(s), all editable in the visual node editor.
More Gmail commands
Ready to automate your busywork?
Start your free 30-day trial today. No credit card, no commitment.