Set up SparkPost
SparkPost's Transmissions API, with idempotency. Arqeno answers exactly as SparkPost 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/sparkpost- Your key goes in
- the Authorization header (the key as is)
- Instead of
https://api.sparkpost.com (or api.eu.sparkpost.com)- Works with
- Node · Python SDKs
- Set the client's origin (Node) or base_uri (Python, host and path without the scheme) to the one below.
- Use an Arqeno key as the API key.
- Each primary recipient is captured as its own email with its CC / BCC copies; an Idempotency-Key replays the first answer.
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.
Good to know
The Python SDK always adds https://; over plain http (local dev only) set transmissions.base_uri yourself.
2. Send a test email
const SparkPost = require("sparkpost");
// staging only: origin points the client at Arqeno, the key is an Arqeno key
const client = new SparkPost(process.env.SPARKPOST_API_KEY, { origin: process.env.SPARKPOST_ORIGIN ?? "https://api-arqeno.shriradhatechnologies.com/e/sparkpost" });
await client.transmissions.send({
content: { from: "noreply@acme.com", subject: "Your code is 482913", text: "Your code is 482913" },
recipients: [{ address: "someone@example.com" }],
});Signed in, this guide has a Try it button that sends a sample email the SparkPost way and reads its code back. Start free.
3. What Arqeno answers
The same status and body SparkPost gives when it accepts an email (HTTP 200), so your code carries on as it would in production:
{"results": {"total_rejected_recipients": 0, "total_accepted_recipients": 1, "id": "<request 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 SparkPost 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 · SendGrid · Amazon SES · MSG91 Email · Postmark · Mailgun · Brevo · ZeptoMail · Netcore Email · Mailjet · Mandrill