SMTP Relay

Send emails using standard SMTP instead of our HTTP API. Perfect for legacy systems, WordPress plugins, or any app that supports SMTP.

Connection Settings

  • Host: mx.sidemail.net
  • Port: 587
  • Encryption: STARTTLS
  • Username: Any value (e.g., api or empty)
  • Password: Your API key

Features

  • Same deliverability as the HTTP API
  • Verified sender validation — emails must come from verified addresses
  • Attachments supported — up to 5MB total message size
  • CC and BCC — fully supported
  • Markdown support — send markdown emails via custom header

Markdown Emails

To send markdown-formatted emails via SMTP, add the X-Sidemail-Markdown: true header to your message. When this header is present, the plain text body is treated as markdown and rendered to HTML.

Code Examples

Limits

  • 5MB maximum message size (including attachments)
  • Sender address must be verified in your project

Troubleshooting

Authentication failed

  • Double-check your API key is correct
  • Make sure the API key belongs to the project you're sending from
  • Verify your account is active and not suspended

Sender not verified

The "From" address must be verified in your Sidemail project. Add and verify it in your dashboard under Sending Identities.

Connection timeout

  • Ensure port 587 is not blocked by your firewall
  • Try using a different network to rule out ISP blocking