Set up SMTP
Any framework or library that sends over SMTP: Nodemailer, Django, Laravel, Rails, JavaMail. Arqeno answers exactly as SMTP would, keeps every email in your Email inbox with its code, links, checks and simulated delivery events — and delivers nothing.
1. What to change
smtp.arqeno.com:587- Your key goes in
- the SMTP password (the username is the key's id part)
- Instead of
your provider's SMTP host- Works with
- Any SMTP client
- Set the SMTP host and port below in your staging settings (STARTTLS on the submission port, or TLS from the start).
- Username: your key's id part (arq_<id>); password: the whole key.
- Send as you do today. Up to 50 recipients and 10 MB a message; port 25 is never open.
Need a key? Create a free workspace and make one on its API keys page — it starts with arq_. The same key works for SMS and every email provider.
2. Send a test email
import nodemailer from "nodemailer";
const transport = nodemailer.createTransport({
host: "smtp.arqeno.com", port: 587, secure: false, requireTLS: true,
auth: { user: "arq_YOUR", pass: "arq_YOUR_KEY" },
});
await transport.sendMail({ from: "Acme <noreply@acme.com>", to: "someone@example.com",
subject: "Your code is 482913", text: "Your code is 482913" });Signed in, this guide has a Try it button that sends a sample email the SMTP way and reads its code back. Start free.
3. What Arqeno answers
The same status and body SMTP gives when it accepts an email (SMTP 250), so your code carries on as it would in production:
250 2.0.0 Ok: queued as <email id>
The email shows up in the Email inbox at once: its code and magic link to copy, a safe preview, attachments, and Checks — links to staging hosts, unfilled placeholders, a spam score and email-client support.
4. Read the code in your tests
One call waits up to 30 seconds for the newest email to an address and hands back its code and magic link — whichever provider sent it. The address goes in the body, never in a URL.
curl -X POST "https://api-arqeno.shriradhatechnologies.com/v1/otp/wait" \
-H "Authorization: Bearer arq_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"to": "someone@example.com", "wait": 25}'
# → {"channel": "email", "code": "482913", "magicLink": "https://…", "subject": "…", …}5. Test bounces and complaints
Nothing is delivered, but every email gets the events SMTP would report. Send to an address with a tag — asha+bounced@acme.test, +complained, +delayed, +suppressed — and read the events back.
# send to asha+bounced@acme.test (or bounced@resend.dev), then:
curl "https://api-arqeno.shriradhatechnologies.com/v1/events?type=email.bounced" -H "Authorization: Bearer arq_YOUR_KEY"
# → {"items": [{"type": "email.bounced", "recipient": "asha+bounced@acme.test",
# "detail": {"smtpCode": "550", "enhancedCode": "5.1.1", …}, …}], "nextAfter": "…"}Other email providers
Resend · SendGrid · Amazon SES · MSG91 Email · Postmark · Mailgun · Brevo · ZeptoMail · SparkPost · Netcore Email · Mailjet · Mandrill