Platform Integration Guides
Step-by-step SMTP setup guides for Auth0, Supabase, WordPress, Customer.io, and Nodemailer.
Platform Integration Guides
Samva's SMTP relay works with any platform that supports custom SMTP. Below are step-by-step guides for popular platforms.
Auth0
Auth0 uses SMTP to send verification emails, password resets, and MFA codes.
- Go to Auth0 Dashboard → Branding → Email Provider
- Select Custom Email Provider
- Enter the following settings:
| Setting | Value |
|---|---|
| SMTP Host | smtp.samva.app |
| SMTP Port | 587 |
| SMTP Username | samva |
| SMTP Password | Your Samva API key |
- Set the From address to an address on your verified Samva domain (e.g.,
auth@yourdomain.com) - Click Save and send a test email to verify
Supabase
Supabase uses SMTP for authentication emails (signup confirmation, password reset, magic links).
- Go to Supabase Dashboard → Project Settings → Authentication
- Scroll to SMTP Settings and enable Custom SMTP
- Enter the following:
| Setting | Value |
|---|---|
| Host | smtp.samva.app |
| Port | 587 |
| Username | samva |
| Password | Your Samva API key |
| Sender email | An address on your verified domain |
| Sender name | Your app name |
- Set Minimum interval between emails as needed
- Click Save
You can test by triggering a password reset from your Supabase app.
WordPress
Use the WP Mail SMTP plugin to route WordPress emails through Samva.
- Install and activate the WP Mail SMTP plugin
- Go to WP Mail SMTP → Settings → General
- Under Mailer, select Other SMTP
- Configure:
| Setting | Value |
|---|---|
| SMTP Host | smtp.samva.app |
| Encryption | TLS |
| SMTP Port | 587 |
| Authentication | On |
| SMTP Username | samva |
| SMTP Password | Your Samva API key |
- Set the From Email to an address on your verified domain
- Go to WP Mail SMTP → Tools → Email Test and send a test email
Customer.io
Customer.io can use a custom SMTP relay for sending transactional and marketing emails.
- Go to Customer.io → Settings → Email
- Under Sending Configuration, select Custom SMTP
- Enter:
| Setting | Value |
|---|---|
| Host | smtp.samva.app |
| Port | 587 |
| Username | samva |
| Password | Your Samva API key |
| Security | STARTTLS |
- Set your default From address to one on your verified domain
- Send a test email to verify the configuration
Nodemailer (Node.js)
For Node.js applications using Nodemailer:
import nodemailer from "nodemailer";
const transporter = nodemailer.createTransport({
host: "smtp.samva.app",
port: 587,
secure: false, // false for STARTTLS, true for port 465
auth: {
user: "samva",
pass: process.env.SAMVA_API_KEY,
},
});
// Send an email
const info = await transporter.sendMail({
from: '"Your App" <noreply@yourdomain.com>',
to: "user@example.com",
subject: "Welcome!",
html: "<h1>Welcome to our app!</h1>",
});
console.log("Message sent:", info.messageId);For connection pooling in production:
const transporter = nodemailer.createTransport({
host: "smtp.samva.app",
port: 587,
secure: false,
auth: {
user: "samva",
pass: process.env.SAMVA_API_KEY,
},
pool: true, // Use connection pooling
maxConnections: 5, // Max simultaneous connections
maxMessages: 100, // Max messages per connection
});Verification Checklist
After configuring any platform:
- Send a test email
- Check your Samva dashboard — the message should appear in your activity log
- Verify the email was delivered to the recipient's inbox
- Check that open/click tracking events appear (if applicable)
If the test fails, see the troubleshooting section.