Docs Providers

MailerSend

Configure MailerSend as your email provider.

About MailerSend

MailerSend is a transactional email service that also supports SMS. It offers a clean API, detailed analytics, and competitive pricing.

Website: mailersend.com

Prerequisites

  1. A MailerSend account
  2. A verified domain
  3. An API token

Getting Your API Token

  1. Log in to MailerSend
  2. Go to Domains and verify your domain first
  3. Go to API Tokens
  4. Click Create new token
  5. Name it and select the domain
  6. Choose permissions (at minimum, Email)
  7. Click Create token
  8. Copy the token

Configuration

Add MailerSend in mailshit:

  1. Go to Settings > Providers
  2. Click Add Provider
  3. Select MailerSend
  4. Enter the following:
FieldDescriptionExample
API KeyYour MailerSend API tokenmlsn.abc123...
From EmailVerified sender emailhello@yourdomain.com
From NameDisplay name (optional)Your Company
  1. Click Save

Domain Verification

MailerSend requires domain verification:

  1. Go to Domains
  2. Click Add domain
  3. Enter your domain name
  4. Add the DNS records MailerSend provides:
    • SPF record
    • DKIM record
    • DMARC record (optional but recommended)
  5. Click Verify

Free Tier

MailerSend offers:

  • 3,000 emails/month free
  • 1 custom domain
  • 30-day log retention
  • Basic analytics

Features

  • Transactional email and SMS
  • Email templates (in addition to mailshit templates)
  • Detailed analytics
  • Inbound email parsing
  • Activity tracking

Example Response

{
  "success": true,
  "type": "sent",
  "messageId": "ms_abc123..."
}

Best Practices

  1. Complete domain verification before sending
  2. Use dedicated IP for high volume (paid feature)
  3. Monitor analytics in MailerSend dashboard
  4. Set up webhooks for bounce/complaint handling

Troubleshooting

“Unauthenticated”

  • Check your API token is correct
  • Ensure token has email permissions

“Domain not verified”

  • Complete domain verification in MailerSend
  • Wait for DNS propagation (up to 48 hours)

“Recipient rejected”

  • Email may be on suppression list
  • Check MailerSend’s Suppressions