Email Actions

The Email group reads, sends and files e-mail. It was rebuilt from scratch since 0.14.2.

Migrating from 0.14.2

There is no Create Client action any more. Every action in this group takes an Email Account entry from the Secure Vault instead of receiving a client object built inside the scenario.

The old actions still appear in saved scenarios as Create Client (deprecated), Read Emails (deprecated), Send Email (deprecated), Move Email (deprecated) and Delete Email (deprecated). They keep working, but they are no longer offered in the actions menu. Rebuild those steps with the actions below.

Before you start

Create an Email Account entry in the Vault — see Email Account entries. An entry can hold an IMAP half, an SMTP half, or both:

Action	Needs
Read Emails, Move Email, Copy Email, Delete Email, Mark Email Seen / Unseen	IMAP
Send Email, Forward Email	SMTP

Every action then has an Email Account parameter where you pick the Vault entry by its key.

📸 Screenshot needed — /img/editor/actions/email/email_account_select.png

Capture: any e-mail action's form with the Email Account dropdown open, listing the Email Account entries available from the Vault. Why it is new: this replaces the two Create Client screenshots (email_client_basic.png, email_client_smtp.png), which document a deprecated action and should be deleted.

---

Read Emails

Fetches messages and exposes them as a list you can loop over.

📸 Screenshot needed — /img/editor/actions/email/email_read.png

Capture: the Read Emails form with Filter by seen status open, plus the Variables panel showing the structure of one fetched message. Why it must be retaken: the form no longer has an Email Client Var field, and Filter by seen status is new.

Parameter	Description
Email Account	Vault entry with an IMAP half.
Folder	Mailbox folder to read. Default INBOX.
Limit	Maximum number of messages to fetch. Default 10. Optional.
Filter by seen status	unset (default) fetches regardless of read state, seen only already-read messages, unseen only unread ones.
Save Emails To Variable	Variable that receives the list. Default emails.

tip

Combine Filter by seen status: unseen with Mark Email Seen / Unseen at the end of the loop body. The scenario then processes each message exactly once, even if it runs every five minutes.

Send Email

📸 Screenshot needed — /img/editor/actions/email/email_send.png

Capture: the Send Email form with Send as HTML visible. Why it must be retaken: the Email Client Var field is gone and Send as HTML is new.

Parameter	Description
Email Account	Vault entry with an SMTP half.
Recipients	Addresses separated by semicolons.
Subject	Message subject. Optional.
Message	Body text. Accepts variables.
Send as HTML	Sends the body as HTML instead of plain text. Default off.

Forward Email

Forwards a message from a Read Emails result to other recipients.

📸 Screenshot needed — /img/editor/actions/email/email_forward.png

Capture: the Forward Email form inside a loop, with Email Message bound to the loop's current item. Why it is new: this action did not exist in 0.14.2.

Parameter	Description
Email Account	Vault entry with an SMTP half.
Email Message	The message to forward — normally the current item of a loop over Read Emails.
Recipients	Addresses separated by semicolons.
Subject	Overrides the forwarded subject. Optional.
Additional Message	Text prepended above the forwarded content. Optional.

Move Email / Copy Email

Files a message into another folder. Move removes it from the source folder; Copy leaves it in place.

📸 Screenshot needed — /img/editor/actions/email/email_move.png

Capture: the Move Email form. Why it must be retaken: the form now takes an Email Account and an Email Message instead of a client variable, a source folder and a UID.

Parameter	Description
Email Account	Vault entry with an IMAP half.
Email Message	The message to file.
Destination Folder	Target folder. Default Archive.

Delete Email

📸 Screenshot needed — /img/editor/actions/email/email_delete.png

Capture: the Delete Email form.

Parameter	Description
Email Account	Vault entry with an IMAP half.
Email Message	The message to delete.

warning

Whether this moves the message to Trash or removes it permanently depends on the mail server. Prefer Move Email into an archive folder when the message might be needed again.

Mark Email Seen / Unseen

📸 Screenshot needed — /img/editor/actions/email/email_mark_seen.png

Capture: the Mark Email Seen / Unseen form showing the Mark as seen toggle. Why it is new: this action did not exist in 0.14.2.

Parameter	Description
Email Account	Vault entry with an IMAP half.
Email Message	The message to flag.
Mark as seen	On (default) marks it read; off marks it unread.

---

Typical mailbox-processing scenario

Step	Action	Notes
1	Read Emails	INBOX, Filter by seen status: unseen, into emails
2	Condition	Exit early if emails is empty
3	Repeat for each item in	over emails, current item email
4	… processing …	inside the loop — save attachments, read data, enter it into the target system
5	Mark Email Seen / Unseen	inside the loop, so the message is not picked up again
6	Move Email	inside the loop, into Processed
7	Send As Email	after the loop — the run report, see Notification