Bulk Mailbox Creation

This guide explains Upload a CSV to create many mailboxes at once with admin-set passwords. so you can complete the TrekMail task with confidence.

Article details

Type, difficulty, plans, and last updated info.

Type
Guide
Difficulty
Beginner
Plans
Starter · Pro · Agency
Last updated
May 28, 2026

Create up to 500 mailboxes at once by uploading a CSV file or pasting tabular data. You provide the email addresses and passwords; mailboxes are created immediately.

Who this is for

  • Admins provisioning many accounts at once (e.g., new team, new department, new domain).
  • Users migrating from another provider who already have a list of addresses and passwords.
  • Anyone who needs admin-controlled credentials for multiple mailboxes.

Tip: If you want recipients to choose their own passwords, use Bulk Invites instead.

Before you start

  • Active domain: Add your domain(s) first. Mailboxes can be created on pending domains, but emails won't flow until DNS is verified.
  • Plan limits: Each domain has a mailbox limit based on your plan (Nano: 10, Starter: 100, Pro: 300, Agency: 1000).
  • Password requirements: Every password must be at least 12 characters and include uppercase, lowercase, and a number.

Step 1: Prepare your data

CSV format

Column Required Description Example
email Yes Full email address john@example.com
password Yes Min 12 chars, upper + lower + number SecurePass123
storage No Dedicated allocation (5 GB, 2048 MB) 5 GB

Example CSV

email,password
john@example.com,SecurePass123
jane@example.com,AnotherPass456,5 GB
support@example.com,HelpDesk789!,2048 MB

The optional storage column controls how much storage that mailbox gets:

  • Empty / column missing — uses the shared pool (the default). All shared mailboxes draw from the same account allowance.
  • 5 GB, 2048 MB, 1.5 GB — pre-allocates that exact amount; the mailbox cannot exceed it. The total of all dedicated allocations across the batch must fit in your remaining account pool, otherwise the batch is rejected with a clear message.

You can mix shared and dedicated rows freely in the same upload.

Supported formats

  • Comma-separated (CSV) -- standard .csv files
  • Tab-separated -- paste directly from Excel or Google Sheets
  • With or without header row -- auto-detected if the first row contains column names like email, password

Step 2: Enter your data

  1. Navigate to Mailboxes in the left sidebar.
  2. In the Create New Mailbox card, select Bulk create.
  3. Paste your data into the text area (one account per line), or drag and drop a .csv file (up to 10MB) into the upload area below.
  4. Click Validate.

Step 3: Review preview

A compact domain limits table shows how many mailboxes you can still create on each domain (used / limit / available).

Below it, all rows are listed in a single table with columns: Email, Password, Status, and Action. Rows with issues appear first so you can fix them before scrolling to the ready ones.

Status What it means What you can do
Weak password Doesn't meet password requirements Click Generate for a strong password, or Edit to type your own
Invalid email Malformed email or invalid local part Remove the row
Invalid storage Storage value is not a recognised size Fix the value (e.g. 5 GB) or remove the row
Domain not found Email uses a domain not in your account Remove the row
Already exists Mailbox already active on that domain Remove the row
Duplicate Same email appears twice in your data Remove the duplicate
Over limit Exceeds plan limit for that domain Remove some Ready rows to free up slots
Over storage pool Earlier dedicated rows exhausted the pool Reduce some allocations, or upgrade the plan
Ready All good -- will be created Show/copy password, or remove if not needed

Fixing weak passwords

  • Generate -- creates a strong password instantly. The row moves to Ready and the new password is shown so you can copy it.
  • Edit -- click the pencil icon next to the password, type your own, and press the checkmark. Password must be at least 12 characters with uppercase, lowercase, and a number.

Removing rows

Click x on any row to remove it. If you remove a Ready row, the first Over Limit row for the same domain is automatically promoted to Ready.

Step 4: Create mailboxes

When satisfied with the preview, click Create X mailboxes. Each mailbox is created individually -- if one fails, the rest still succeed (partial success).

After creation:

  • Download Credentials: Click Download CSV to save a file containing all created email addresses and their passwords. Share this file securely with mailbox owners.
  • DNS warnings: If any domains aren't DNS-verified yet, a warning shows which ones need attention.
  • Failed rows: Listed with specific error reasons so you can fix and retry.

Important: The credentials CSV is generated once and not stored on the server. Save it immediately.

Limits

Setting Value
Maximum rows per batch 500
Maximum CSV file size 10 MB
Maximum input text length 500,000 characters
Password minimum length 12 characters
Password requirements Uppercase + lowercase + number

Troubleshooting

Problem Solution
"No data rows found" Check your CSV has data rows below the header
"Required columns missing" Ensure your data has at least email and password columns
"Too many rows" Split your data into batches of 500 or fewer
Many "Weak password" errors All passwords need 12+ chars with upper, lower, and number
Many "Domain not in account" Add those domains to your account first under Domains
Partial success Download the results, fix failed rows, and re-upload just those

API access

You can also bulk create mailboxes via the REST API:

POST /api/v1/mailboxes:bulk

See the API Overview for details.

Related articles

Jump to nearby guides that continue the workflow.

We use cookies for essential functionality. No ads, no ad tracking.

Sign in to TrekMail

Access your dashboard, mailboxes and DNS.

or
or

Reset email sent

If an account exists for this email, we've sent password reset instructions.

By continuing, you agree to TrekMail's Terms and Privacy Policy.