Getting Started with MailerLogic

MailerLogic helps you send emails reliably from your own domain and track what happens after they’re delivered. This guide walks you through the basics, from setting up your account to sending your first test email, even if you have no prior experience with email APIs or SMTP.

By the end of this article, you’ll understand the core setup steps and be able to send an email successfully using MailerLogic.

Before You Begin

To start sending emails, a few one-time setup requirements must be completed.

You’ll need:

An active MailerLogic account
An API key, which securely identifies your account
A sending domain (for example, mail.yourdomain.com) that emails will be sent from

If your domain isn’t verified yet, you’ll complete that in the next steps.

Step 1: Get Your API Key

Your API key allows MailerLogic to authenticate requests made from your account.

You can find your API key in the 'MailerLogic dashboard', under your 'Profile' settings. It will look similar to this:

ml_live_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef

Keep your API key private.
Do not share it publicly or store it in public repositories. Anyone with this key can send emails using your account.

Add and Verify Your Sending Domain

A sending domain confirms that you’re authorized to send emails from a specific domain. This is essential for good deliverability and brand trust.

You can add and verify your domain using either the MailerLogic dashboard or the API.

Add Your Domain (API – Optional)

Use the following API call to register your domain:

curl -X POST https://api.mailerlogic.net/api/v1/customer/domains \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mail.yourdomain.com"}'

Add DNS Records

MailerLogic provides DNS records such as SPF and DKIM. Add these records to your DNS provider (for example, Cloudflare, GoDaddy, or Google Domains).

To retrieve DNS records via API:

curl https://api.mailerlogic.net/api/v1/customer/domains/{DOMAIN_ID}/dns \
  -H "X-API-Key: YOUR_API_KEY"

Verify Your Domain

Once the DNS records are added, verify your domain.

From the dashboard, click Verify, or via API:

curl -X POST https://api.mailerlogic.net/api/v1/customer/domains/{DOMAIN_ID}/verify \
  -H "X-API-Key: YOUR_API_KEY"

Step 2: Add Domain

Open 'Sending Domains' under 'Domains' and click the 'Add Domain' button.

Step 3: Add Domain

Enter the 'Domain Name' and click the button 'Add Domain'.

Step 4: Verify your Domain

Click the 'Verify' button to verify your domain, and you'll see the status 'Verified'.

DNS changes can take up to 48 hours to propagate. Once verified, your domain status will update to Verified.

Step 5: Send Your First Email

After your domain is verified, you’re ready to send a test email.

Open 'Test Mail' from the menu, enter the 'To Address'. Update the 'Subject' and 'Content' as needed

Enable tracking options if required:

Open tracking (tracks email opens)
Click tracking (tracks link clicks)

Finally, click 'Send Test Email.'

If successful, the email will arrive in the recipient’s inbox. Simply click the link sent via email to view it.

Understand Tracking and Analytics

Step 6: View Analytics

MailerLogic automatically tracks what happens after your email is sent.

Analytics and logs include:

Total sent
Delivered
Opened
Clicked
Bounced (hard and soft)
Complaints
Blocked and pending emails

Go to 'Reports' and select 'Analytics'. You can filter results by 'Date Range' and view charts for delivery and engagement trends.

Tracking can be disabled for specific emails from your account settings if needed.

Step 7: Track Reports

Monitoring usage helps you stay within sending limits and plan email volume effectively.

Go to 'Reports' and open 'Logs' from the list. Choose the 'Custom Start & End Range', choose the 'Chart Type', and use the 'Refresh' button if needed.

Step 8: Monitor Usage and Sending Limits

Go to 'Reports' and select 'Usage' from the list. View your 'Monthly Usage', 'Daily Usage', and other details according to your plan.

What to Do Next

Once you’re comfortable with basic sending, you can explore advanced features:

Test your email content
Analyze content quality before sending large campaigns.

curl -X POST https://api.mailerlogic.net/api/content-score \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject": "Your Newsletter", "html": "<html>...</html>", "text": "..."}'

Set up webhooks
Receive real-time notifications for delivery, opens, clicks, bounces, and unsubscribes.

curl -X POST https://api.mailerlogic.net/api/v1/customer/webhooks \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-domain.com/webhooks/mailerlogic",
    "events": ["delivered", "open", "click", "bounce", "complaint"],
    "is_active": true
  }'

Best Practices for Beginners

Always use verified domains
Start with small email volumes
Monitor bounce and complaint rates
Respect unsubscribes and suppressions
Test content before large sends

Common Issues and Fixes

Domain not verified
Ensure all DNS records are added correctly and allow time for propagation.

SMTP authentication failed
Generate fresh SMTP credentials from the dashboard or API.

Rate limit exceeded
Check your usage limits in the dashboard.

Need Help?

If you need assistance:

🌐 Help Center: https://support.mailerlogic.com
📧 Email: support@mailerlogic.com

Getting started with MailerLogic may feel technical at first, but once your domain is verified and your first email is sent, the rest becomes much easier. Take it step by step; you only need to complete the setup once.

Was this article useful?

Dislike