Skip to main content

Email Setup

Before you can send emails through Sendmator, you need to verify your domain and configure your sender identity.

Prerequisites

  • Access to your domain's DNS settings
  • A valid email address on your domain

Step 1: Access Email Settings

Navigate to Email Settings in your Sendmator dashboard.

Step 2: Verify Your Domain

Domain verification ensures you own the domain you're sending from and improves email deliverability.

Add DNS Records

  1. In the Email Settings page, enter your domain (e.g., yourdomain.com)

  2. Sendmator will generate DNS records for you to add:

    • SPF Record - Authorizes Sendmator to send emails on your behalf
    • DKIM Record - Adds a digital signature to your emails
    • DMARC Record - Protects your domain from spoofing
    • Return-Path Record - Handles bounce messages
  3. Add these DNS records to your domain provider:

# Example DNS Records (values will be unique to your domain)

# SPF Record
Type: TXT
Host: @
Value: v=spf1 include:sendmator.com ~all

# DKIM Record
Type: TXT
Host: sendmator._domainkey
Value: v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GN...

# DMARC Record
Type: TXT
Host: _dmarc
Value: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com

# Return-Path (Custom Bounce Domain)
Type: CNAME
Host: bounce
Value: bounce.sendmator.com

Verify DNS Records

After adding the DNS records:

  1. Wait 5-15 minutes for DNS propagation
  2. Click "Verify Domain" in the Sendmator dashboard
  3. Once verified, you'll see a green checkmark
DNS Propagation

DNS changes can take up to 48 hours to fully propagate, but usually complete within 15 minutes. Use DNS Checker to verify your records are live.

Step 3: Create Email Identity

Once your domain is verified, create email identities for sending emails.

Add Email Identity

  1. In Email Settings, go to Email Identities section
  2. Click Add Email
  3. Enter your email address on the verified domain (e.g., noreply@yourdomain.com)
  4. Set the From Name (e.g., "Your Company Name")
  5. Click "Save"
No Verification Needed

Since your domain is already verified, email identities created on that domain are automatically ready to use - no verification email required.

Step 4: Set Default Email Identity

You can set a default email identity for all your emails:

  1. Go to Email Settings → Email Identities
  2. Select your preferred email identity
  3. Click "Set as Default"
  4. This email and name will be used by default for all sends
Using Custom From Addresses

Even with a default set, you can override the from_email and from_name in each API request using the respective parameters.

Using Email Identity in API Requests

Once your domain is verified and email identity is created, you can send emails:

curl -X POST https://api.sendmator.com/api/v1/messages/send \
-H "X-API-Key: sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"recipient_type": "direct_email",
"direct_email": "user@example.com",
"from_email": "noreply@yourdomain.com",
"from_name": "Your Company",
"subject": "Welcome!",
"content": "<h1>Hello!</h1>"
}'

Troubleshooting

Domain Verification Fails

Issue: DNS records not detected

Solutions:

  • Wait longer for DNS propagation (up to 48 hours)
  • Verify records were added to the correct domain/subdomain
  • Check for typos in the DNS values
  • Use DNS Checker to verify records are live
  • Contact your DNS provider for assistance

Emails Going to Spam

Issue: Emails landing in recipient spam folders

Solutions:

  • Ensure all DNS records (SPF, DKIM, DMARC) are properly configured
  • Warm up your domain by starting with smaller send volumes
  • Avoid spam trigger words in subject lines
  • Include an unsubscribe link in promotional emails
  • Monitor your sender reputation

Best Practices

1. Use Descriptive From Names

Make it clear who the email is from:

# ✅ Good
"from_name": "Acme Corp Support"
"from_name": "John from Acme"

# ❌ Avoid
"from_name": "noreply"
"from_name": "no-reply@acme.com"

2. Match From Address with Email Content

Use different from addresses for different types of emails:

# Transactional emails
"from_email": "noreply@yourdomain.com"
"from_name": "Your App"

# Marketing emails
"from_email": "marketing@yourdomain.com"
"from_name": "Your App Newsletter"

# Support emails
"from_email": "support@yourdomain.com"
"from_name": "Customer Support"

3. Monitor Your Sender Reputation

  • Check bounce rates regularly
  • Remove invalid email addresses
  • Honor unsubscribe requests immediately
  • Maintain good list hygiene

Email Settings Dashboard

Manage all your email configuration at app.sendmator.com/mail-settings:

  • Domains - Add, verify, and manage domains
  • Email Identities - Create and manage sender identities
  • Default Settings - Set default email identity
  • DNS Records - View required DNS records
  • Verification Status - Check domain verification status
  • Sending Statistics - Monitor email performance

Next Steps

Need help? Contact support or check our troubleshooting guide.