Fastmail icon

Fastmail

Actions for Fastmail messages, labels, drafts and threads

Actions30

Thread → Get a Thread

AI-generated

Summary

Fetch a thread's metadata and optionally its messages and attachments

Inputs

  • fetchOptions — Optional fetch options for filtering and controlling response details, including read status, search, body inclusion, attachment download, etc.
  • threadId (required) — Identifier of the thread to retrieve.

Output shape

a thread summary object containing thread metadata such as id, messageCount, unreadCount, latestMessageSubject, latestMessageFrom, latestMessageAt, latestMessagePreview, and optionally emailIds when includeEmailIds is enabled

The response includes a debug field when debug is enabled containing the raw JMAP response; attachments are not included in this operation's output.

Examples

Example 1: Retrieve thread details by ID

Set Resource to Thread, Operation to Get a Thread, enter the Thread ID, optionally enable Include Body Values or Download Attachments.

Example 2: Search and filter threads

Set Resource to Thread, Operation to Get a Thread, provide Thread ID, add a Search term and Read Status filter in Fetch Options.

Links

Discussion