Actions are specified with the action argument to a Filter definition. The action parameter takes either a single action or a list of actions, for example:
action: delete action: [report-pyzor, forward-to firstname.lastname@example.org, delete]
The follwing actions are built-in. More actions can be added through plugins.
Copies the message to a folder. The folder is created if it does not exist.
action: copy-to INBOX/Spam
Moves the message to a folder. The folder is created if it does not exist.
action: move-to INBOX/Business
Deletes the message
Sets an IMAP flag. The set of flags depends on the server. Probably the most minimal set of flags is:
\Answered. Flags supported by other servers are:
\Flagged and even user defined flags.
Remember that the backslash
\ needs to be doubled because it is itself used to quote single characters.
action: set-flag \\Flagged
Clears an IMAP flag. See set-flag.
action: clear-flag \\Deleted
Reports the message to Pyzor as spam. The pyzor filter will then detect the same message as spam.
Reports the sending server’s IP to badips.com as spammer.
Forwards the message to another e-mail address. For this, an SMTP account has to be defined in `global-parameters`_.
action: forward-to email@example.com
Stop processing further filters for this message. This is only useful in combination with nested filter lists.