Set up Mailjet

Mailjet's Send API v3.1 and v3. Arqeno answers exactly as Mailjet would, keeps every email in your Email inbox with its code, links, checks and simulated delivery events — and delivers nothing.

1. What to change

Host for Mailjet
api-arqeno.shriradhatechnologies.com/e/mailjet
Your key goes in
basic auth: the secret key is the Arqeno key (the API key part is ignored)
Instead of
api.mailjet.com
Works with
Node · Python SDKs
  1. Node: set config.host to the host below. Python: api_url = <api>/e/mailjet/ (with the trailing slash).
  2. Use an Arqeno key as the secret key.
  3. Every message in Messages is its own email; if one is invalid, the whole request is refused.

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

mailjet_rest 1.6+ only allows mailjet.com hosts: subclass its Config with ALLOWED_ROOT_DOMAIN set to Arqeno's host (shown in the Python snippet).

node-mailjet always uses https.

2. Send a test email

import Mailjet from "node-mailjet";

// staging only: config.host points the client at Arqeno; the secret is an Arqeno key (the API key is ignored)
const mailjet = new Mailjet({ apiKey: "arqeno", apiSecret: process.env.MAILJET_SECRET_KEY,
  config: { host: process.env.MAILJET_HOST ?? "api-arqeno.shriradhatechnologies.com/e/mailjet", version: "v3.1" } });
await mailjet.post("send", { version: "v3.1" }).request({ Messages: [{
  From: { Email: "noreply@acme.com" }, To: [{ Email: "someone@example.com" }],
  Subject: "Your code is 482913", TextPart: "Your code is 482913" }] });

Signed in, this guide has a Try it button that sends a sample email the Mailjet way and reads its code back. Start free.

3. What Arqeno answers

The same status and body Mailjet gives when it accepts an email (HTTP 201), so your code carries on as it would in production:

{"Messages": [{"Status": "success", "CustomID": "", "To": [{"Email": "…", "MessageUUID": "<email id>", "MessageID": 7352918986, "MessageHref": "…"}], "Cc": [], "Bcc": []}]}

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 Mailjet 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 · SparkPost · Netcore Email · Mandrill