Documentation

Getting Started with MailVibee

Everything you need to go from signup to your first successful campaign in under 5 minutes.

1. Create Your Account

Head to the signup page and create your account with your name, email, and a password (minimum 8 characters). You'll be logged in immediately and taken to your dashboard.

2. Add an SMTP Account

Navigate to SMTP Accounts in the sidebar. You'll need:

SMTP Server: Your email provider's SMTP host (e.g., smtp.hostinger.com, smtp.gmail.com)
Port: Usually 465 for SSL or 587 for TLS
Security: SSL (recommended) or TLS
Email & Password: Your email account credentials
Sender Name: The name recipients see (e.g., "Jane from Acme")

Your SMTP password is encrypted with AES-256-CBC before storage. Add multiple accounts for automatic SMTP rotation.

3. Create a Template (Optional)

Go to Templates and click "New Template." Use the WYSIWYG editor to write your email just like you would in Gmail. Use personalization tags like ${name} or ${company} that will be replaced with CSV data at send time.

4. Prepare Your CSV File

Create a CSV file with at minimum an email column. Add any additional columns and they automatically become personalization tags:

        email,name,company,position

        jane@acme.com,Jane Smith,Acme Corp,CTO

        bob@techflow.io,Bob Lee,TechFlow,VP Engineering

Column headers are case-insensitive — Name, name, and NAME all work with ${name}. MailVibee also auto-combines first_name + last_name into ${name} if no name column exists.

5. Create a Campaign

Go to Campaigns → "New Campaign." Fill in:

Campaign Name: Internal label for your reference
Template: Pick a saved template or write custom content
Subject Line: Supports ${tags} for personalization
Email Body: Your email content with personalization tags
CSV File: Upload your contacts file
Delay: Seconds between each email (default 35s, recommended 30-60s)
Attachment: Optional file attachment (max 10MB)
Open Tracking: Toggle to enable/disable pixel tracking

6. Send Your Campaign

After creating a campaign, you'll see the campaign view with all contacts loaded. Click "Start Sending" to begin. The background worker:

Rotates through your active SMTP accounts sequentially
Replaces all ${tags} with CSV data per recipient
Inserts the ${signature} tag with your saved signature
Respects the delay between each email
Continues sending even if you close the browser tab

You can pause sending at any time. The current email will finish, then the worker stops.

7. Available Template Tags

Tag	Source	Description
`${name}`	CSV	Recipient name (auto-detected)
`${email}`	CSV	Recipient email address
`${company}`	CSV	From CSV "company" column
`${signature}`	Settings	Your saved email signature
`${any_column}`	CSV	Any CSV column header becomes a tag

8. Gmail SMTP Setup

To use Gmail as an SMTP account:

Enable 2-Factor Authentication on your Google Account
Generate an App Password at myaccount.google.com/apppasswords
Use smtp.gmail.com, port 587, security TLS
Use the App Password (not your regular Gmail password)

Need Help?

Reach out to hello@vibeecodex.com — we reply within 24 hours.