Email setup
Point your app’s email at Arqeno in staging or CI — over SMTP, or through your email provider’s API with only its base URL changed. Arqeno answers like that provider, keeps every email in your Email inbox with its code, links, attachments and checks — and delivers nothing.
Two ways in
- SMTP — any framework or library (Nodemailer, Django, Laravel, Rails, JavaMail): set the SMTP host to
smtp.arqeno.com, port 587 with STARTTLS; the username is your key’s id part, the password the whole key. SMTP guide. - A provider’s API — keep its official SDK and change only the base URL (or host) and the key. Each provider below has its own guide.
Steps
- Create a free workspace — Email is on from the start — and an API key (shown once).
- In staging, change the SMTP settings or your provider’s base URL, and use the Arqeno key.
- Send as usual. The email appears in the Email inbox at once, with its checks.
- In tests, read the code or magic link back with the test API.
Guides by provider
- SMTPAny framework or library that sends over SMTP: Nodemailer, Django, Laravel, Rails, JavaMail.Any SMTP client
- ResendThe Resend API and its official SDKs.Node · Python SDKs
- SendGridTwilio SendGrid's Mail Send API (v3) and its SDKs.Node · Python SDKs
- Amazon SESSES API v2 (SendEmail) through the AWS SDKs, signed with SigV4.boto3 · AWS SDK v3
- MSG91 EmailMSG91's Email API v5, template sends with variables.HTTP API
- PostmarkPostmark's Email API: single, batch and template sends.Node SDK · HTTP
- MailgunMailgun's Messages API, including batch sending.Node · Python SDKs
- BrevoBrevo's transactional email API (smtp/email).Node · Python SDKs
- ZeptoMailZoho ZeptoMail: single, batch and template sends.Node SDK · HTTP
- SparkPostSparkPost's Transmissions API, with idempotency.Node · Python SDKs
- Netcore EmailNetcore Cloud (Pepipost) email API, v5 and v6.pepipost SDKs · HTTP
- MailjetMailjet's Send API v3.1 and v3.Node · Python SDKs
- MandrillMailchimp Transactional (Mandrill): send and send-template.Node · Python SDKs
What to change for each
| Provider | Set | To | Your key goes in |
|---|---|---|---|
| SMTP | SMTP host | smtp.arqeno.com:587 | the SMTP password (the username is the key's id part) |
| Resend | Base URL | https://api-arqeno.shriradhatechnologies.com/e/resend | the Authorization header (Bearer), where your Resend key goes |
| SendGrid | API host | https://api-arqeno.shriradhatechnologies.com/e/sendgrid | the Authorization header (Bearer), where your SendGrid key goes |
| Amazon SES | Endpoint | https://api-arqeno.shriradhatechnologies.com/e/ses | AWS-style credentials Arqeno issues for a key (SigV4) |
| MSG91 Email | Send URL | https://api-arqeno.shriradhatechnologies.com/e/msg91/api/v5/email/send | the authkey header |
| Postmark | Request host | api-arqeno.shriradhatechnologies.com/e/postmark | the X-Postmark-Server-Token header (the server token) |
| Mailgun | API URL | https://api-arqeno.shriradhatechnologies.com/e/mailgun | basic auth: user api, password the key |
| Brevo | Base URL | https://api-arqeno.shriradhatechnologies.com/e/brevo/v3 | the api-key header |
| ZeptoMail | URL | https://api-arqeno.shriradhatechnologies.com/e/zeptomail/ | the Authorization header: Zoho-enczapikey <key> |
| SparkPost | Origin | https://api-arqeno.shriradhatechnologies.com/e/sparkpost | the Authorization header (the key as is) |
| Netcore Email | Base URI | https://api-arqeno.shriradhatechnologies.com/e/netcore/v5 | the api_key header (v5) or Authorization: Bearer (v6) |
| Mailjet | Host | api-arqeno.shriradhatechnologies.com/e/mailjet | basic auth: the secret key is the Arqeno key (the API key part is ignored) |
| Mandrill | Base path | https://api-arqeno.shriradhatechnologies.com/e/mandrill/api/1.3 | key in the JSON body, where your Mandrill key goes |
What every email is checked for
- Links that still point at a staging, localhost or private host.
- Placeholders left unfilled —
{{name}},*|FNAME|*,%recipient.x%— and a leaked “undefined”. - Inbox rules: Gmail’s 102 KB clip, images without alt text, Gmail and Yahoo’s sender rules.
- Email-client support for the HTML and CSS it uses (e.g. flexbox in Outlook for Windows), and a spam score.
- Templates: paste a copy of a provider template and every email that uses it is checked for missing, empty or misspelt variables.
Bounces and complaints
Nothing is delivered, but every email gets the events its provider would report. Send to an address with a tag — asha+bounced@acme.test, +complained, +delayed, +suppressed — and read the events with GET /v1/events (test API).