How to bulk upload mailboxes

Step-by-step guide to adding multiple mailboxes via CSV file

🚀 Getting Started!

If you need to connect multiple mailboxes to Warmy at once, the Bulk Upload feature makes this process quick and efficient. Instead of manually connecting each mailbox, which can be time-consuming, you can upload a CSV file with all the necessary information. This allows you to save time and ensure that all mailboxes are connected correctly. Follow the steps below to ensure a smooth setup.

📌 How to Bulk Upload Mailboxes

1. Open the Bulk Upload Option

   • Navigate to the +Mailbox tab and select Bulk Upload.
     
     

2. Select Your Subscription Plan

   • Choose the subscription under which the mailboxes will be added.

3. Download the CSV Template (Recommended)

   • We provide a template file with the correct format for bulk upload.
   • This step is optional but highly recommended to ensure accuracy.

   • The CSV template requires the following details for each mailbox:

     • Email Address
     • SMTP & IMAP Username
     • SMTP & IMAP Password
     • SMTP & IMAP Host & Port

     You can find this information in the SMTP settings of your email server. Different providers store these details in different places. We recommend visiting our Connections Guide, selecting your provider, and checking where to find that data exactly.

   • Additional Fields & Recommendations:

     • Use SMTP SSL/TLS – We recommend setting this to true.
     • Use IMAP SSL/TLS – Also recommended to be true (or false if no IMAP).
     • Use IMAP – Set this to true if entering IMAP credentials, or false if not.
     • From Name – This is the Send from name displayed on emails. It can also be updated in the Mailboxes section. (It’s useful for setting up inbox filters)
     • Private Key – Leave this empty unless required. Some providers, like Mailgun, may use it, and it's recommended (!) to fill it in when connecting Mailgun mailboxes.
     • Authentication Method – We recommend keeping this field set  login for all mailboxes.

4. Upload Your CSV File

   • Select and upload the file containing your mailbox details. Only CSV format is supported.

5. File Verification

   • Warmy will scan the file and display the total number of mailboxes detected.

⚠️ Common Errors & Solutions

1. Not Enough Available Slots

   • The number of mailboxes in your file exceeds the available slots in your subscription.
   • Solution: Remove some mailboxes from the file or purchase additional plans (click Upgrade).

2. File Exceeds the 1000 Mailbox Limit

   • You can upload a maximum of 1000 mailboxes per file.
   • Solution: Split your list into multiple files and upload them separately.

3. Incorrect File Format or Data Errors

   • Only CSV files are supported.
   • Incorrect or unrecognized mailbox details may cause upload failures.
   • Solution: Download the CSV template and ensure all data is correctly formatted before re-uploading.

✅ Completing the Upload

• Click Upload once your file is ready.
• You’ll be redirected to the Mailboxes page, where you’ll find the From Files section.

🔍 Here, you can see:

• The name of the uploaded list.
• The total number of mailboxes in the file.
• How many were successfully connected.
• How many failed to connect.

🔎 Checking Status

• ✅ Green checkmark – The list was successfully added(might not fully).
• ❌ Failed Mailboxes Report – If some mailboxes fail to connect, you’ll see a Download failed emails button. Clicking it will let you download a file listing failed mailboxes along with reasons for failure.

📝 Summary

Bulk uploading in Warmy is a fast and efficient way to connect multiple mailboxes. To ensure a smooth process, download the CSV template, confirm you have enough available slots, and double-check data accuracy. If errors occur, use the Download failed emails option to troubleshoot.