IMAP Read

io.imap-read Input v0.1.0

Reads messages from an IMAP mailbox (unseen or all, newest first) — optionally only the ones not seen on previous runs, so a Schedule trigger + IMAP Read is an email poller.

Ports

DirectionPortLabel
InputinputInput
OutputoutputMessages

Properties

PropertyTypeDefaultDescription
Credential
credentialId		 credential "" Use a stored credential for this connection — its fields are filled in at run start. Pick "None" to enter the connection details manually.
accepts credential templates: imap
Host
host		 string "" IMAP server hostname, e.g. imap.example.com.
Port
port		 int 993 IMAP port — typically 993 for implicit TLS, 143 for STARTTLS.
Implicit TLS
secure		 boolean true Connect encrypted from the first byte (port 993). Off = plain connect upgraded with STARTTLS.
User
user		 string "" IMAP username.
Password
password		 string "" IMAP password — supports ${credential.NAME.FIELD}.
Mailbox
mailbox		 string "INBOX" The mailbox to read.
Search
search		 select "unseen" Unseen reads only messages without the \Seen flag; All reads everything.
unseenall
Limit
limit		 int 10 Maximum messages to read, newest first. 0 = all.
Mark as seen
markSeen		 boolean true Flag the fetched messages \Seen so the next unseen search skips them.
Only new messages
onlyNew		 boolean true Only emit messages not seen on previous runs (remembered per mailbox in the global key-value store). Pair with a Schedule trigger to poll an inbox.
Body
bodyMode		 select "text" Text fetches the text/plain body; None reads headers only.
textnone
Timeout (ms)
timeoutMs		 int 15000 Abort the whole conversation after this many milliseconds.
Verify TLS certificate
rejectUnauthorized		 boolean false Verify the server's TLS certificate. Off (default) accepts self-signed certificates — the io.sql "require" semantics.

This page is generated from the node registry by gen-node-docs.mjs on every site build — ports, properties, defaults and visibility rules cannot drift from the code.