Fastmail Trigger icon

Fastmail Trigger

Triggers on Fastmail message events using JMAP event stream

Fastmail Trigger

AI-generated

Summary

Triggers workflows on Fastmail email events via JMAP and Server-Sent Events (SSE), monitoring for new emails, deletions, and read/unread status changes.

Inputs

  • events (required) — Select which events trigger the workflow (e.g., newEmail, deletedEmail, read, unread, updated).
  • mailboxScope (required) — Watch all mailboxes or a single specific mailbox.
  • filterLabelId (required) — Filter events to a specific mailbox. Required when 'Specific Mailbox' is selected.
  • emitExistingOnStart — If true, emit recent matching messages when the workflow is activated.
  • initialLimit — Limit the number of existing messages emitted on start (min 1).
  • pingSeconds — Frequency of server keepalive pings (0 to disable).
  • maxReconnectDelaySeconds — Maximum backoff delay in seconds after a disconnect.
  • forceReconnectMinutes — Periodically reconnect as a safety measure (0 to disable).

Output shape

A list of items where each item is an email object wrapped in a JSON object containing the event type and source.

Deleted events include only the messageId. The email payload includes standard fields like messageId, subject, preview, receivedAt, threadId, mailboxIds, from, to, and isRead.

Examples

Example 1: Watch for new emails in the 'Inbox' folder only.

Events: newEmail; Mailbox Scope: Specific; Filter by Label: Inbox ID

Example 2: Trigger on emails being moved to Trash (deletedEmail).

Events: deletedEmail; Mailbox Scope: All Mailboxes

Example 3: Trigger on read/unread changes across all mailboxes.

Events: read, unread; Mailbox Scope: All Mailboxes

Links

Discussion