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
-
In the Email Settings page, enter your domain (e.g.,
yourdomain.com) -
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
-
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:
- Wait 5-15 minutes for DNS propagation
- Click "Verify Domain" in the Sendmator dashboard
- Once verified, you'll see a green checkmark
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
- In Email Settings, go to Email Identities section
- Click Add Email
- Enter your email address on the verified domain (e.g.,
noreply@yourdomain.com) - Set the From Name (e.g., "Your Company Name")
- Click "Save"
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:
- Go to Email Settings → Email Identities
- Select your preferred email identity
- Click "Set as Default"
- This email and name will be used by default for all sends
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
- Send Email API - Start sending emails
- Email Templates - Create reusable templates
- Multi-Channel API - Send across multiple channels
Need help? Contact support or check our troubleshooting guide.