Email API - RESTful Email Sending API

Quick Start

1. Get API Key

Sign up & generate key

2. Verify Domain

Add DNS records

3. Send Email

POST to /v1/messages/send

API Endpoint

POST https://api.sendmator.com/v1/messages/send

Headers

X-API-KEY: YOUR_API_KEY
Content-Type: application/json

Request Body

JSON Payload

{
  "channel": ["email"],
  "recipient_type": "direct_email",
  "direct_email": "user@example.com",
  "direct_first_name": "John",
  "direct_last_name": "Doe",
  "from_email": "noreply@yourdomain.com",
  "from_name": "Your App Name",
  "subject": "Welcome to Our Platform",
  "content": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
  "plain_text_content": "Welcome! Thanks for signing up.",
  "attachment_ids": ["att_abc123"],
  "metadata": {
    "user_id": "12345",
    "campaign": "onboarding"
  }
}

Response

✅ Success (200 OK)

{
  "success": true,
  "trigger_id": "trg_abc123",
  "job_id": "job_xyz789",
  "message": "Email queued successfully"
}

❌ Error (400/401/500)

{
  "success": false,
  "error": "Invalid API key",
  "code": "AUTH_FAILED"
}

Code Examples

cURL

curl -X POST https://api.sendmator.com/v1/messages/send \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<EOF
{
  "channel": ["email"],
  "recipient_type": "direct_email",
  "direct_email": "user@example.com",
  "from_email": "noreply@yourdomain.com",
  "subject": "Test Email",
  "content": "<p>Hello World</p>"
}
EOF

JavaScript (Node.js)

const response = await fetch('https://api.sendmator.com/v1/messages/send', {
  method: 'POST',
  headers: {
    'X-API-KEY': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    channel: ['email'],
    recipient_type: 'direct_email',
    direct_email: 'user@example.com',
    from_email: 'noreply@yourdomain.com',
    subject: 'Test Email',
    content: 'Hello World'
  })
});

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

Python

import requests

response = requests.post(
    'https://api.sendmator.com/v1/messages/send',
    headers={
        'X-API-KEY': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'channel': ['email'],
        'recipient_type': 'direct_email',
        'direct_email': 'user@example.com',
        'from_email': 'noreply@yourdomain.com',
        'subject': 'Test Email',
        'content': 'Hello World'
    }
)

print(response.json())

Save 2-3 Hours on Setup

Traditional Email APIs (SendGrid, Mailgun, AWS SES)

⏱️ 30-60 min: Account setup & verification
⏱️ 30-45 min: SMTP configuration
⏱️ 20-30 min: Domain authentication (DKIM, SPF, DMARC)
⏱️ 30-60 min: Understanding complex API docs
⏱️ 15-30 min: Setting up webhooks & tracking
Total: 2-3 hours

Sendmator

✅ 1 min: Sign up & generate API key
✅ 2 min: Verify domain (DNS only)
✅ 1 min: Create sender email
✅ 1 min: Send first email
✅ No SMTP config needed
Total: 5 minutes

⚡ 96% faster setup

Fast Delivery

Average API response: 200ms. Emails delivered in seconds.

Multi-Channel

Email + SMS + WhatsApp + Push in one API. Save hours integrating multiple services.

Secure & Compliant

TLS encryption, DKIM signing, SPF/DMARC support. 99.9% uptime.

Email API for Developers