Email Import Overview

The TrekMail import tool copies your existing emails from another provider into a TrekMail mailbox — without deleting anything from your current account. It runs in the background, so you can close your browser while it works.

Tip: Launch the interactive How to Import guided tour directly on the Import page. Click the "How to import" button to walk through each step with real-time highlights.

How it works

TrekMail offers two import modes:

Single Import

A guided 3-step wizard for importing one account at a time:

1. Step 1 — Connect: Select your email provider and enter your source credentials. We verify the connection and load your folder list.
2. Step 2 — Choose: Pick which folders to import and configure options like duplicate skipping and date filters.
3. Step 3 — Import: Choose the destination TrekMail mailbox, review the summary, and start the import.

Bulk Import

Upload a CSV file to migrate many accounts at once — up to 1,000 per batch on Agency plans. See Bulk Email Migration for the full guide.

API and MCP access

In addition to the dashboard, you can manage migrations programmatically:

• REST API — Test connections, start migrations, monitor progress, cancel, retry, and delete via /api/v1/migrations endpoints. Pro and Agency get full migration access through the API (migrations:read + migrations:write). Starter can read migration data via API and run new migrations from the dashboard. See API Overview for details.
• MCP server — AI agents can run single and bulk migrations using 13 dedicated tools. Migration write tools require the TREKMAIL_ALLOW_MIGRATION=true environment flag and per-call confirmation. See Connecting AI Agents for setup.

What is imported?

• ✅ Emails: All messages in Inbox, Sent, Drafts, and custom folders you select.
• ✅ Folder structure: Your folders are recreated in TrekMail.
• ✅ Read/unread status: Preserved where the source provider reports it.

What is NOT imported?

• ❌ Contacts & Calendars: The import tool handles email only. Export and re-import these separately.
• ❌ Filters & Rules: Recreate your forwarding and sorting rules inside TrekMail after the import.
• ❌ Your old account: Nothing is deleted from your original provider.

Before you start

• Do not cancel your old hosting yet. Verify the import is 100% complete before cutting over.
• Switch MX records first (recommended). Point your domain's MX records to TrekMail so new mail arrives here, then run the import to catch up on historical email.