Mandrill Bridge

Drop-in replacement for the Mandrill (Mailchimp Transactional) API: keep the key-in-body convention and your requests, swap in your wemail API key.

Mandrill / Mailchimp Bridge

The Mandrill bridge lets you migrate from Mandrill (Mailchimp Transactional) to wemail without changing your integration code. Point your base URL to https://api.wemail.io/bridge/mandrill, put your wemail API key in the same key field of each request body, and keep the same request and response shapes — sends, template sends, message search, and reject listings all work the same way.

Authentication

Exactly like Mandrill, every endpoint is a POST with the API key in the JSON body's key field. Use your wemail API key (afn_live_… or afn_test_…) where your Mandrill key (md-…) used to be. Test-environment keys route through the sandbox: messages are accepted, simulated, and never delivered.

{ "key": "afn_live_YOUR_WEMAIL_KEY", "message": { … } }

Supported Endpoints

POST /bridge/mandrill/api/1.0/messages/send.json

Send a message.

POST /bridge/mandrill/api/1.0/messages/send-template.json

Send using a stored template.

POST /bridge/mandrill/api/1.0/messages/search.json

Search sent messages.

POST /bridge/mandrill/api/1.0/messages/info.json

Get a single message's details.

POST /bridge/mandrill/api/1.0/rejects/list.json

List the rejection (suppression) list.

POST /bridge/mandrill/api/1.0/users/ping.json

Health check — returns "PONG!".

POST /bridge/mandrill/api/1.0/users/info.json

Account info + sending stats envelope.

Field-Level Compatibility

POST /messages/send.json — message fields

Response

A successful send returns 200 with the Mandrill array — one entry per recipient: [{ _id, email, status: "sent", reject_reason: null }]. Errors return the Mandrill error object { status: "error", code, name, message } (ValidationError, InvalidKeyError, …).

POST /rejects/list.json

Returns the Mandrill rejects array: [{ email, reason, detail, created_at, last_event_at, expires_at, expired, subaccount }] with wemail suppressions mapped to Mandrill reasons (hard-bounce, spam, unsub).

Webhooks

When the Mandrill bridge is active, webhook deliveries are formatted exactly like Mandrill webhooks: an application/x-www-form-urlencoded POST with the event batch JSON in the mandrill_events field, signed with the X-Mandrill-Signature header (base64 HMAC-SHA1 over the webhook URL + sorted POST params, Mandrill's exact scheme). Event names use Mandrill vocabulary (send, hard_bounce, soft_bounce, open, click, spam, unsub, reject).

Known Deviations from Mandrill API

Code examples

curl -X POST https://api.wemail.io/bridge/mandrill/api/1.0/messages/send.json \
  -H "Content-Type: application/json" \
  -d '{
    "key": "afn_live_YOUR_KEY",
    "message": {
      "from_email": "sender@yourdomain.com",
      "to": [{ "email": "user@example.com" }],
      "subject": "Hello from the Mandrill bridge",
      "html": "<p>It works — zero code changes.</p>"
    }
  }'

// Mailchimp Transactional SDK — point the client at the wemail bridge
const mailchimp = require('@mailchimp/mailchimp_transactional')('afn_live_YOUR_KEY');
mailchimp.setDefaultOutputFormat('json');
// The official SDK pins mandrillapp.com; for the bridge use plain fetch:
const res = await fetch('https://api.wemail.io/bridge/mandrill/api/1.0/messages/send.json', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    key: 'afn_live_YOUR_KEY',
    message: {
      from_email: 'sender@yourdomain.com',
      to: [{ email: 'user@example.com' }],
      subject: 'Hello from the Mandrill bridge',
      html: '<p>It works — zero code changes.</p>',
    },
  }),
});
console.log(await res.json()); // [{ _id, email, status: 'sent', … }]

import requests

resp = requests.post(
    "https://api.wemail.io/bridge/mandrill/api/1.0/messages/send.json",
    json={
        "key": "afn_live_YOUR_KEY",
        "message": {
            "from_email": "sender@yourdomain.com",
            "to": [{"email": "user@example.com"}],
            "subject": "Hello from the Mandrill bridge",
            "html": "<p>It works — zero code changes.</p>",
        },
    },
)
print(resp.status_code, resp.json())  # 200 [{'_id': 'msg_…', 'status': 'sent', ...}]