API Documentation

Build powerful email integrations with our comprehensive RESTful API. Send emails, manage mailboxes, and automate workflows programmatically.

Get API KeyView Endpoints
Fast & Reliable
Low-latency API with 99.9% uptime SLA
Secure
API key authentication with role-based access
RESTful
Standard REST conventions with JSON responses

Quick Start

1

Get Your API Key

Sign up and generate an API key from your dashboard settings.

2

Make Your First Request

Use your API key to authenticate and send your first email.

3

Build Your Integration

Explore all endpoints and build powerful email workflows.

Request Example

// Send an email using the CalimaticMail API
// Base URL: https://api-email.calimatic.com/v1
//       or: https://api.calimatic.app/v1
const response = await fetch('https://api-email.calimatic.com/v1/emails/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: 'hello@yourdomain.com',
    to: ['recipient@example.com'],
    subject: 'Welcome to our platform!',
    html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    text: 'Welcome! Thanks for signing up.',
  }),
});

const result = await response.json();
console.log('Email sent:', result.id);

Response

{
  "success": true,
  "data": {
    "id": "msg_1234567890",
    "status": "queued",
    "from": "hello@yourdomain.com",
    "to": ["recipient@example.com"],
    "subject": "Welcome to our platform!",
    "createdAt": "2024-12-15T10:30:00Z"
  }
}
Base URL (recommended):
https://api-email.calimatic.com/v1
Alternative URL:
https://api.calimatic.app/v1

Both URLs point to the same API. We recommend the .com domain for new integrations as it offers better compatibility with enterprise networks.

API Endpoints

Authentication

POST/auth/login
POST/auth/refresh
POST/auth/logout

Sending Emails

POST/emails/send
POST/emails/send-batch
GET/emails/{id}/status

Mailboxes

GET/mailboxes
POST/mailboxes
GET/mailboxes/{id}
DELETE/mailboxes/{id}

Messages

GET/messages
GET/messages/{id}
PATCH/messages/{id}
DELETE/messages/{id}

Users & Teams

GET/users
POST/users
PATCH/users/{id}
DELETE/users/{id}

Templates

GET/templates
POST/templates
POST/templates/{id}/render

Authentication

API Key Authentication

Include your API key in the Authorization header for all requests.

Authorization: Bearer YOUR_API_KEY

Security Best Practices

  • ✓Never expose API keys in client-side code
  • ✓Use environment variables for key storage
  • ✓Rotate keys periodically for security

Rate Limits

PlanRequests/minEmails/day
Starter601,000
Professional30010,000
Enterprise1,000Unlimited

Rate limit headers are included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Ready to Start Building?

Get your API key and start sending emails in minutes. Our team is here to help if you have any questions.

Get Started FreeContact Support