Getting Started
Welcome to Risu Mail. This guide will walk you through the essential steps to move from account creation to sending your first production-ready email via our API or SMTP relay.
Platform Architecture
Risu Mail is built on a distributed edge-first architecture, ensuring that your emails are queued and dispatched from the nearest available node. We support two primary interfaces: a modern REST API for dynamic application logic and a robust SMTP Relay for legacy system compatibility.
Our system is divided into three core layers: the ingestion layer (API/SMTP), the processing layer (Templates/Anti-Spam), and the delivery layer (High-Reputation IPs).
1. Account and Identity Verification
Create your account via the primary dashboard. We recommend using an institutional or company domain if you intend to apply for high-volume sending quotas or student developer benefits.
Once registered, verify your sender domain or email identity. This step is critical; unverified domains are restricted to 'Sandbox' mode, where you can only send to your own registered address to prevent platform abuse.
2. API Key Management
Navigate to the 'API Keys' section. Risu Mail uses granular scoping. For standard email delivery, generate a key with the 'mail_api' scope. For backend-only verification logic, use 'server_otp'.
Security Reminder: Your secret keys are only visible once upon creation. Store them in a secure environment variable manager like Vercel Secrets or GitHub Actions Secrets.
3. Choosing your Integration Path
REST API (Recommended): Best for modern applications. Supports template injection, dynamic recipient arrays, and immediate status feedback.
SMTP Relay: Best for existing software (WordPress, NodeMailer, PHPMailer). Requires no new code, just a configuration change in your mail settings.
Ready to integrate?
Start building with our free tier and follow our detailed API contract.