MailerLogic API (1.0.0)

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Tracking & Analytics

Q: How does open tracking work?

We insert a tiny invisible 1x1 pixel image in your emails. When the recipient opens the email and images load, we record the open event.

Limitations:

• Requires images to be enabled
• Privacy features in Apple Mail/Gmail may block tracking

Q: How does click tracking work?

We automatically rewrite all links to route through our tracking domain. When clicked, we record the event and redirect to the original URL (typically under 100ms).

Q: Can I disable tracking for specific emails?

Yes, tracking can be disabled:

• Globally in account settings
• Per domain
• Per email (coming soon via API/SMTP headers)

Q: How long do you store tracking data?

• Event data: 90 days
• Aggregated statistics: Indefinitely
• Detailed logs: 30 days

Enterprise plans can request extended retention.

Q: What timezone are timestamps in?

All timestamps are in UTC (Coordinated Universal Time) using ISO 8601 format: 2024-03-15T14:30:00Z

Deliverability

Q: What is IP warm-up and do I need it?

IP warm-up gradually increases sending volume on a new IP address to build reputation with ISPs.

You need it for:

• New dedicated IPs
• IPs idle for 30+ days
• Significantly increased volume

We automate this process over 2-4 weeks.

Q: How do I improve my sender reputation?

• Authenticate your domain (SPF, DKIM, DMARC)
• Send quality content (use content scoring)
• Maintain good list hygiene
• Monitor engagement metrics
• Follow proper IP warm-up schedules
• Maintain steady sending patterns

Q: What should my bounce rate be?

• Good: Below 2%
• Acceptable: 2-5%
• Poor: Above 5%

If your bounce rate exceeds 10%, we may pause sending to protect your reputation.

Q: What should my complaint rate be?

• Good: Below 0.1%
• Acceptable: 0.1-0.5%
• Poor: Above 0.5%

Complaint rates above 1% may result in account suspension.

Q: How do suppression lists work?

Suppression lists prevent sending to addresses that have:

• Hard bounced
• Soft bounced repeatedly
• Complained (marked as spam)
• Unsubscribed
• Been manually added

Automatic suppression happens immediately.

Q: Can I whitelist specific addresses?

Yes, you can whitelist addresses to bypass suppression. Use this carefully for:

• Test accounts
• Internal email addresses
• Verified opt-in addresses only

Security & Compliance

Q: How secure is my data?

• All API requests use HTTPS (TLS 1.2+)
• SMTP uses STARTTLS/SSL/TLS
• API keys encrypted at rest
• Database connections encrypted
• Regular security audits

Q: Can I rotate my API key?

Yes, use the /api/customer/rotate-key endpoint. The old key is invalidated immediately, so update all applications with the new key.

Q: Can I rotate my SMTP password?

Yes, use the /api/smtp-credentials/rotate endpoint with your X-API-Key header.

Q: Is MailerLogic GDPR compliant?

Yes, we provide:

• Data processing agreements (DPA)
• Right to erasure (deletion)
• Data export capabilities
• Privacy-focused tracking options
• Opt-out/unsubscribe management

Q: How do I implement unsubscribe?

We automatically add:

• List-Unsubscribe header (standard email client unsubscribe)
• One-click unsubscribe (RFC 8058 compliant)
• Unsubscribe link

You can also manage suppressions via API.

Q: What data do you collect?

We collect:

• Sending data: From, to, subject, timestamps
• Tracking data: Opens, clicks, IP addresses, user agents
• Event data: Bounces, complaints, delivery status
• Account data: Usage statistics, API access logs

We do NOT store full email content or attachments.