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.
▼
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
.csvfiles - 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
- Navigate to Mailboxes in the left sidebar.
- In the Create New Mailbox card, select Bulk create.
- Paste your data into the text area (one account per line), or drag and drop a
.csvfile (up to 10MB) into the upload area below. - 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.