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
const response = await fetch('https://api.calimatic.app/v1/emails/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: '[email protected]',
    to: ['[email protected]'],
    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": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Welcome to our platform!",
    "createdAt": "2024-12-15T10:30:00Z"
  }
}
Base URL:
https://api.calimatic.app/v1

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