Documentation version: Latest (v1)
Technical Guide
Quickstart Guide
The fastest path to your first 'Hello World' email with Risu Mail.
1. Generate a key
Go to Dashboard > API Keys. Create a new key named 'Quickstart' with 'mail_api' scope. Copy the secret immediately.
2. Run a cURL request
Open your terminal and run the following command (replace with your key and email):
curl -X POST https://risu.in/api/v1/emails -H 'Authorization: Bearer <YOUR_KEY>' -H 'Content-Type: application/json' -d '{"to": "you@example.com", "subject": "Risu Test", "html": "<p>It works!</p>"}'
3. Confirm in logs
Refresh your dashboard logs. You should see a new entry with 'QUEUED' or 'SENT' status within seconds.
Ready to integrate?
Start building with our free tier and follow our detailed API contract.