SMTP Configuration
Detailed SMTP relay configuration reference including ports, TLS settings, authentication, and limits.
SMTP Configuration
Connection Settings
| Setting | Value | Notes |
|---|---|---|
| Host | smtp.samva.app | |
| Port (STARTTLS) | 587 | Recommended. Connection starts unencrypted, upgrades via STARTTLS |
| Port (SSL/TLS) | 465 | Implicit TLS. Connection is encrypted from the start |
| Encryption | TLS required | Both ports require TLS encryption |
Authentication
| Setting | Value |
|---|---|
| Method | PLAIN or LOGIN |
| Username | samva |
| Password | Your Samva API key (e.g., sk_sm_...) |
The username is a fixed literal — all authentication is done via the API key password. This matches the convention used by other email providers.
Limits
| Limit | Value |
|---|---|
| Max message size | 25 MB (including attachments) |
| Max recipients per message | 50 |
| Sender domain | Must be verified in Samva dashboard |
Port Selection
Port 587 (STARTTLS) — Recommended for most integrations. The connection starts as plain text and upgrades to TLS via the STARTTLS command. This is the standard submission port defined in RFC 6409.
Port 465 (Implicit TLS) — The connection is encrypted from the first byte. Some legacy applications or strict firewall environments require this port.
Port 25 — Not supported. Most cloud providers block outbound port 25.
Sender Address
The From: address in your email must use a domain that is verified in your Samva dashboard. If you attempt to send from an unverified domain, the SMTP server will reject the message with a 550 error.
Message Tracking
SMTP-sent messages appear in your Samva dashboard with the same tracking as API-sent emails:
- Delivery status — pending, sent, delivered, bounced, failed
- Open tracking — when recipients open the email
- Click tracking — when recipients click links
- Bounce handling — automatic suppression list management
- Activity log — full message history with metadata
Messages sent via SMTP are tagged with smtp in the activity log for easy filtering.
Troubleshooting
Authentication failed
- Verify your API key is correct and not expired
- Ensure the API key is enabled in your dashboard
- Check that the username is exactly
samva
Domain not verified
- The sender address domain must be verified in your Samva dashboard
- Go to Settings → Email → Domains to verify your domain
Connection timeout
- Ensure your network allows outbound connections on port 587 or 465
- Some corporate firewalls block SMTP ports — contact your network administrator
- Try switching between port 587 and 465
Message size exceeded
- The maximum message size is 25 MB including all attachments
- Consider using smaller attachments or linking to hosted files