> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Universal Mailbox Sync

> Stably sync mailbox metadata, full body, and attachments over IMAP and POP3.

# Universal Mailbox Sync

Universal Mailbox Sync brings enterprise or personal email into your product. It syncs message metadata, full bodies, and attachments into the project inbox and file storage. It fits customer-support, business-notification, after-sales, and recruiting mailboxes that need reliable long-term intake.

***

## What it can do

* Connect multiple enterprise or personal mailboxes.
* Sync message metadata and retrieve full email bodies.
* Decode and upload attachments to project file storage.
* Run background sync for new mail, with retries and isolation between mailboxes.

<Note>
  Cloud computing and file storage are prepared by superun as needed. You usually do not need to manage these dependencies yourself.
</Note>

***

## What to prepare

| Item                      | Notes                                                             |
| ------------------------- | ----------------------------------------------------------------- |
| Mailbox address           | The enterprise or personal mailbox to sync                        |
| Client authorization code | Use an auth code or app password, not the mailbox login password  |
| IMAP / POP3               | Confirm client access is enabled, or prepare host and port        |
| Provider details          | Pick a common provider, or enter IMAP/POP3 host and port manually |

***

## Mailbox access requirements

You do not need Feishu, DingTalk, or WeCom admin permissions, but the mailbox provider must allow client access.

| Setting                         | Purpose                            | Notes                                                      |
| ------------------------------- | ---------------------------------- | ---------------------------------------------------------- |
| IMAP                            | Discover and sync metadata         | Usually under Settings → Client authorization or POP3/IMAP |
| POP3                            | Retrieve full body and attachments | Enable with IMAP and follow in-product guidance            |
| Client auth code / app password | Sign in via client protocols       | Do not use the web login password                          |

Common providers:

| Provider                 | Confirm                                                           |
| ------------------------ | ----------------------------------------------------------------- |
| Tencent Enterprise Mail  | Enable client receive and use a client password or auth code      |
| NetEase Enterprise / 163 | Enable IMAP/POP3 and use an auth code                             |
| Other enterprise mail    | Confirm IMAP/POP3 host, port, secure connection, and app password |

***

## Enable in superun

<Steps>
  <Step title="Click Use">
    Open Universal Mailbox Sync in the Skill Library and click Use in the top right.
  </Step>

  <Step title="Configure mailboxes">
    For each mailbox, enter the address, provider or IMAP/POP3 host and port, and an auth code or app password.
  </Step>

  <Step title="Verify sync">
    Confirm new messages appear in the inbox and attachments open correctly.
  </Step>
</Steps>

***

## Limits

* Use an auth code or app password; do not use the mailbox login password.
* The first sync imports recent mail by default and does not walk the full history.
* The China-region sync path does not support Gmail, Outlook, Yahoo, or other overseas providers that are unreliable on domestic networks.
* Configure and verify mailboxes separately so one failure does not block others.
* Keep auth codes in the product config page; do not paste them into public chats.
* Enabling or disabling this skill may change project code and consume compute credits.