MailSetu

SMTP-to-REST email API

Send email through your own mail server, from one API.

Connect your SMTP account once. Every application you run then sends through MailSetu with a single API key, and every send is logged with its outcome.

  • Your provider keeps your sender and reputation
  • Keys shown once, stored as hashes
  • Failures return a clear reason
curl -X POST https://equivalent-alisa-spideyofficial777-c749c4c7.apps.mistral.run/v1/emails/send \
  -H "Authorization: Bearer ms_live_…" \
  -H "Content-Type: application/json" \
  -d '{"smtp_id": 1, "to": ["customer@example.com"],
       "subject": "Your order has shipped"}'

# 200 OK
{"status": "accepted_by_smtp", "message_id": "<7f3a@…>"}

Works with the SMTP provider you already use

50recipients per request across to, cc, and bcc
10 MBof attachments per request, up to 10 files
120sends per minute per API key
AES-256GCM encryption for every stored SMTP password

Features

Built for developers who already have a mail provider

Your provider, your sender

Use the SMTP account you already pay for. Each message leaves from the sender address you configured, so mail keeps your domain and your reputation.

One key per application

Create an API key for each app and revoke it on its own. Keys are shown once and stored only as hashes.

Every send is logged

See which messages your mail server accepted and which failed, with the reason, from the dashboard or the API.

Attachments, CC, and BCC

Send HTML or plain text, add attachments, and use CC and BCC in one request. Dangerous file types are blocked before anything leaves the server.

Secure by default

Certificates are always verified, connections are time-limited, and private network addresses are refused unless you enable them.

Simple to call

One HTTPS POST with JSON. Send from your backend with cURL, Python, Node, or PHP. No templates to learn; you bring your own message body.

New

Automatic API webhooks

Pass webhook_url per request or bind one to your API key. Get instant email.sent and email.failed events with zero extra secrets.

New

Batch and template variables

Send up to 50 personalized messages in one /v1/emails/batch call, using per-recipient {{variables}}.

New

Live SMTP toggle and DNS health

Pause or enable any SMTP account live from your dashboard, and verify SPF, DKIM, and DMARC records in one click.

API

Send in one request

Authenticate with a bearer key, name the SMTP account and sender, and send. A 200 means your mail server accepted the message. It does not confirm inbox delivery.

  • Keys look like ms_live_…. Keep them on your server.
  • Requests with any other from address are rejected.
  • Failures return a clear reason, for example an authentication error.
curl -X POST https://equivalent-alisa-spideyofficial777-c749c4c7.apps.mistral.run/v1/emails/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "smtp_id": 1,
    "from": "no-reply@yourdomain.com",
    "to": ["customer@example.com"],
    "subject": "Your order has shipped",
    "text": "Your order is on its way."
  }'

How it works

Three steps to your first send

  1. Create an account

    Sign up and confirm your email address.

  2. Add an SMTP account

    Enter your provider's host, port, and sender address, then test the connection.

  3. Create an API key

    Send with one request to /v1/emails/send.

A send marked as accepted means your mail server took the message. It does not confirm inbox delivery.

Start sending through your own server today

Bring your own SMTP account. Setup takes a few minutes.