zMailer API Documentation

# Option 1: X-API-Key header (recommended)
curl -H "X-API-Key: zm_live_your_key" ...

# Option 2: Bearer token
curl -H "Authorization: Bearer zm_live_your_key" ...

curl -X POST https://zmailer-api.zavecoder.com/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: zm_live_your_api_key" \
  -d '{
    "to": "user@example.com",
    "subject": "Welcome!",
    "html": "<h1>Hello!</h1><p>Welcome to our service.</p>"
  }'

{
  "success": true,
  "messageId": "0100018d1234abcd-12345678...",
  "logId": "550e8400-e29b-41d4-a716-446655440000"
}

const response = await fetch(
  'https://zmailer-api.zavecoder.com/send',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'zm_live_your_api_key',
    },
    body: JSON.stringify({
      to: 'user@example.com',
      subject: 'Hello World',
      html: '<h1>Hello!</h1>',
    }),
  }
);

const result = await response.json();
console.log(result);

import requests

response = requests.post(
    'https://zmailer-api.zavecoder.com/send',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'zm_live_your_api_key',
    },
    json={
        'to': 'user@example.com',
        'subject': 'Hello World',
        'html': '<h1>Hello!</h1>',
    },
)

print(response.json())

<h1>Hello {{name}}!</h1>
<p>Welcome to {{company}}.</p>
<p>Your order #{{order_id}} is confirmed.</p>

{
  "to": "user@example.com",
  "templateSlug": "order-confirmation",
  "variables": {
    "name": "John",
    "company": "Acme Inc",
    "order_id": "12345"
  }
}

curl -X GET "https://zmailer-api.zavecoder.com/stats?days=7" \
  -H "X-API-Key: zm_live_your_api_key"

{
  "period": {
    "days": 7,
    "from": "2024-01-01T00:00:00.000Z",
    "to": "2024-01-08T00:00:00.000Z"
  },
  "stats": {
    "total": 1250,
    "sent": 1200,
    "delivered": 1180,
    "failed": 35,
    "bounced": 15
  },
  "daily": [
    { "date": "2024-01-01", "total": 150, "delivered": 145, "failed": 5 }
  ],
  "byDomain": {
    "example.com": { "total": 1250, "sent": 1200, "failed": 50 }
  }
}