Set up SendGrid
Twilio SendGrid's Mail Send API (v3) and its SDKs. Arqeno answers exactly as SendGrid would, keeps every email in your Email inbox with its code, links, checks and simulated delivery events — and delivers nothing.
1. What to change
https://api-arqeno.shriradhatechnologies.com/e/sendgrid- Your key goes in
- the Authorization header (Bearer), where your SendGrid key goes
- Instead of
https://api.sendgrid.com- Works with
- Node · Python SDKs
- Point the SDK at the URL below: Node sgMail.client.setDefaultRequest("baseUrl", …) AFTER setApiKey() (it resets the URL); Python SendGridAPIClient(key, host=…).
- Use an Arqeno key as the API key. The Node SDK's warning that it doesn't start with SG. is harmless.
- Each personalization is captured as its own email, as SendGrid sends it.
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 sgMail from "@sendgrid/mail";
sgMail.setApiKey(process.env.SENDGRID_API_KEY); // staging: arq_YOUR_KEY
// staging only — AFTER setApiKey (it resets the base URL to SendGrid's):
sgMail.client.setDefaultRequest("baseUrl", "https://api-arqeno.shriradhatechnologies.com/e/sendgrid/");
await sgMail.send({ from: "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 SendGrid way and reads its code back. Start free.
3. What Arqeno answers
The same status and body SendGrid gives when it accepts an email (HTTP 202), so your code carries on as it would in production:
(empty body; the message id in the X-Message-Id header)
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 SendGrid 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
SMTP · Resend · Amazon SES · MSG91 Email · Postmark · Mailgun · Brevo · ZeptoMail · SparkPost · Netcore Email · Mailjet · Mandrill