Actions12
Message → Search
AI-generatedSummary
Search for messages in a mailbox using IMAP search criteria and return matching UIDs.
Inputs
- mailbox — Mailbox to search (e.g., INBOX). Defaults to INBOX if not set.
- searchJson — IMAP search criteria expressed as a JSON object. Defaults to
{seen: false}(unseen messages). - limit — Maximum number of UIDs to return. Defaults to 100.
Output shape
json
Each execution returns a single item with a JSON field containing: uids (array of numbers, limited by limit) and total (number of all matches).
Examples
Example 1: Find unread messages in INBOX, limit 50.
Use defaults: mailbox INBOX, searchJson {seen: false}, limit 50.
Example 2: Search for messages with subject containing 'invoice' in a specific mailbox.
Set mailbox to target folder, searchJson to {subject: 'invoice'}, limit to desired value.