Fastmail icon

Fastmail

Actions for Fastmail messages, labels, drafts and threads

Actions30

Message → Get Many Messages

AI-generated

Summary

Retrieve up to the configured number of Fastmail messages, newest first, with optional mailbox, read status, and full-text search filters. Each result includes a simplified message record; optional settings add body values, attachment binaries, message IDs, or raw JMAP response data.

Inputs

  • Limit — Maximum number of messages to return; defaults to 50 (minimum 1).
  • Mailbox Scope — Search all mailboxes by default, or select a specific mailbox to filter results.
  • Filter by Label Name or ID (required) — Mailbox to search when Mailbox Scope is Specific Mailbox.
  • Fetch Options: Read Status — Return any messages, only read messages, or only unread messages.
  • Fetch Options: Search — Simple full-text search across message content and metadata.
  • Fetch Options: Include Body Values — Include available text and HTML body values in each message record; off by default.
  • Fetch Options: Download Attachments — Download attachments into binary output; off by default. Binary fields use the configured prefix plus a one-based index.
  • Fetch Options: Attachment Binary Property Prefix — Prefix for downloaded attachment binary property names; defaults to attachment_.
  • Fetch Options: Include Message IDs — Declared option, but this Message operation does not consume it; message IDs are included only in the Thread getMany operation.
  • Fetch Options: Debug — Include the raw JMAP query response under debug in each result.

Output shape

A list of items, one per matched message.

Each JSON record contains the message ID, subject, preview, received time, thread ID, mailbox IDs, formatted from/to/cc addresses, read and draft flags, and attachment metadata when present. Body fields are included when requested. If attachment downloads are enabled and a message has attachments, the item also includes binary properties and attachment metadata with each binary property name. No matches produce an empty list. With Continue On Fail enabled, an item-level failure is returned as { "error": "..." }.

Links

Discussion