Fastmail icon

Fastmail

Actions for Fastmail messages, labels, drafts and threads

Actions30

Draft → Get Many Drafts

AI-generated

Summary

Retrieves a list of draft emails from the authenticated Fastmail account.

Inputs

  • limit — Maximum number of draft results to return. Defaults to 25. Must be at least 1.
  • fetchOptions — Collection of optional filtering and retrieval settings. Includes 'Read Status' (any/read/unread), 'Search' (full-text query), 'Include Body Values' (includes text/html body in output), 'Download Attachments' (saves attachments to binary properties), 'Attachment Binary Property Prefix' (prefix for binary property names), and 'Include Message IDs' (includes raw JMAP message IDs).

Output shape

a list of items, each representing a single draft with simplified metadata and optional body/attachment content.

Only drafts (messages with the $draft keyword) are returned. The default limit is 25. If 'Download Attachments' is enabled, attachments are saved as binary properties with names prefixed by the configured 'Attachment Binary Property Prefix'.

Examples

Example 1: List the first 10 drafts regardless of read status.

Limit: 10; Read Status: Any; Search: (empty)

Example 2: Find unread drafts containing the word 'invoice' and include their HTML body content.

Read Status: Unread; Search: invoice; Include Body Values: true

Example 3: Retrieve draft details including text and HTML body content and download all attachments as binary data.

Include Body Values: true; Download Attachments: true; Attachment Binary Property Prefix: my_draft_att_

Links

Discussion