---
title: Move email
description: Automatically move emails between folders based on workflow input and defined rules.
category: Email
tags: [email, automation, imap, message routing, integration]
---

# Move email

## Description

The **Move Email** activity allows you to automatically move email messages from one folder to another within a connected email system .

This activity is commonly used for email classification, archiving, or automation purposes in workflows that handle communications, support tickets, approvals, or notifications.

Use this activity to:

- Automatically archive processed emails to designated folders
- Organize incoming messages based on custom criteria
- Clean up an inbox or triage emails into workflow-specific folders

> **Use case**:  
> After processing support request emails, this activity can be used to move those emails from the `Inbox` to the `Resolved Tickets` folder using message identifiers from the previous activity.

## Input

| Input Type | Status   |
| ---------- | -------- |
| **Data**   | Required |

## Output

| Output Type | Format | Description                              |
| ----------- | ------ | ---------------------------------------- |
| **Data**    | JSON   | Confirmation of moved emails and results |

| Field Name                    | Description                                                                                                                                                                                                                 |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connection**                | Email server connection details (e.g., IMAP). Includes host, port, and credentials.                                                                                                                                         |
| **Message Identifier Column** | Column containing the email’s unique ID (e.g., message UID or ID) used to locate it on the server.                                                                                                                          |
| **Configuration Map**         | A rule-based mapping table using three columns: <br> • **Status** – Name of the input column to check (e.g., "Status") <br> • **Value** – Value to match <br> • **Folder** – Destination folder if the condition is matched |

## Sample Input

_Not applicable_

## Sample Configuration

| Field                     | Value                          |
| ------------------------- | ------------------------------ |
| `connection.id`           | `imap-office365`               |
| `messageIdentifierColumn` | `email_uid`                    |
| `configuration`           | `Status → Folder Mapping->Map` |

Example folder mapping:

| Column | Value     | Folder         |
| ------ | --------- | -------------- |
| Status | Approved  | Archived       |
| Status | Escalated | Priority Inbox |
| Status | Pending   | Review Queue   |

## Sample Output

| Email UID | Status    | Target Folder    | Result |
| --------- | --------- | ---------------- | ------ |
| 8722      | Processed | Archived         | Moved  |
| 8723      | Completed | Resolved Tickets | Moved  |
| 8724      | Escalated | Priority Inbox   | Moved  |

> Emails are moved based on the status-to-folder mapping logic defined in the configuration.