---
title: "append message · RUAL Documentation"
description: "Files a raw message into a mailbox : typically a copy of what smtp send email just delivered, into the Sent folder, so the thread is complete in the use…"
canonical: https://docs.rual.nl/block-types/imap/imapconnection_append
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Blueprint Language](https://docs.rual.nl/engine)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# append message

This block is part of the [`imap`](https://docs.rual.nl/block-types/imap) group and was last modified in core [`v15.0.1`](https://docs.rual.nl/core-versions/150001).

Files a raw message into a mailbox : typically a copy of what `smtp send email` just delivered, into the Sent folder, so the thread is complete in the user's mail client.

- flow `flow`

- connection required `imapconnection`

- mailbox `value` Mailbox to file into, e.g. `Sent`. Defaults to `INBOX`.

Default `INBOX`

- raw message `value` The complete RFC 822 message, headers and body.

- file `file` Read the raw message from a stored `.eml` file instead. Ignored when `raw` is filled.

- flags `array` Flags for the new message. Defaults to `[seen]`.

- date `value` Arrival date to record. ISO date, RFC 3339 or epoch; empty lets the server use now.

- flow `flow`

- connection `imapconnection`

- success `condition`

- error `value`

- uid `number`

Runs APPEND with the raw RFC 822 message (raw pin, or a stored .eml through the file pin) into mailbox. flags defaults to [seen] : a copy of your own message is not unread mail; pass [] for none. date sets the arrival date (defaults to now on the server). uid is the new message's uid when the server reports it (UIDPLUS). Bare LF line endings are normalized to CRLF. At most 50 MB. Suppressed in a simulation.

| `save to sent` |
| --- |
| `imap append` |
| `store email` |

A typical wiring for [append message](https://docs.rual.nl/block-types/imap/imapconnection_append): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [move messages](https://docs.rual.nl/block-types/imap/imapconnection_move) feeds the `connection` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%2520ui/state_debug).

[![Studio canvas example for the append message block: typical wiring for append message.](https://docs.rual.nl/canvas-examples/imapconnection_append.png)](https://docs.rual.nl/canvas-examples/imapconnection_append.png?v=3)

## Version history

Introduced in [`v15.0.1`](https://docs.rual.nl/core-versions/150001).

- [Back to `imap`](https://docs.rual.nl/block-types/imap): Return to the main group to view all sub-groups

- [Back to `imap`](https://docs.rual.nl/block-types/imap?group=imap): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)