{
  "email": "admin@yourcompany.com",
  "password": "your-password"
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "uuid",
    "email": "admin@yourcompany.com",
    "name": "Admin User",
    "role": "TENANT_ADMIN",
    "tenantId": "uuid"
  }
}

curl -X POST https://your-domain.com/api/email/send \
  -H "x-api-key: kf_em_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Your Invoice #INV-2024-001",
    "serviceType": "TRANSACTIONAL",
    "htmlBody": "
Invoice Ready
Your invoice for $299.00 is ready.
",
    "urgency": "HIGH",
    "referenceType": "INVOICE",
    "referenceId": "INV-2024-001"
  }'

curl -X POST https://your-domain.com/api/email/send \
  -H "x-api-key: kf_em_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Your Login OTP",
    "serviceType": "OTP",
    "htmlBody": "
Your OTP is: 483921
This code expires in 5 minutes.
",
    "urgency": "HIGH"
  }'

curl -X POST https://your-domain.com/api/email/send \
  -H "x-api-key: kf_em_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Welcome to Our Platform",
    "serviceType": "TRANSACTIONAL",
    "templateId": "template-uuid-here",
    "templateVariables": {
      "name": "John Doe",
      "company": "Acme Inc",
      "activationLink": "https://app.example.com/activate/abc123"
    }
  }'

{
  "messageId": "8b33601b-9c94-45f1-8613-6b10973b31b0",
  "status": "queued"
}

{
  "attachments": [
    {
      "filename": "invoice.pdf",
      "contentType": "application/pdf",
      "content": "JVBERi0xLjQKJcfs..."
    }
  ]
}

import fs from 'fs';

const base64Content = fs.readFileSync('./invoice.pdf').toString('base64');

await fetch('https://your-domain.com/api/email/send', {
  method: 'POST',
  headers: { 'x-api-key': 'kf_em_xxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    to: 'user@example.com',
    subject: 'Your Invoice',
    serviceType: 'TRANSACTIONAL',
    htmlBody: '
See attached invoice.
',
    attachments: [{ filename: 'invoice.pdf', contentType: 'application/pdf', content: base64Content }],
  }),
});

{
  "id": "uuid",
  "status": "DELIVERED",
  "serviceType": "TRANSACTIONAL",
  "provider": "SENDGRID",
  "retryCount": 0,
  "errorCode": null,
  "createdAt": "2026-06-24T08:46:18.929Z",
  "deliveredAt": "2026-06-24T08:46:21.102Z"
}

{
  "data": [
    {
      "id": "uuid",
      "serviceType": "TRANSACTIONAL",
      "subject": "Your Invoice #INV-2024-001",
      "status": "DELIVERED",
      "provider": "SENDGRID",
      "retryCount": 0,
      "createdAt": "2026-06-24T08:46:18.929Z",
      "deliveredAt": "2026-06-24T08:46:21.102Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 142, "totalPages": 3 }
}

{ "reason": "Maintenance window" }

{
  "name": "Gmail recipients via Brevo",
  "description": "Route all emails to gmail.com via Brevo",
  "priority": 10,
  "recipientDomain": "gmail.com",
  "providerName": "BREVO",
  "fromEmail": "notifications@yourdomain.com"
}

{
  "dataRetentionDays": 45,
  "auditRetentionDays": 45,
  "autoPurgeEnabled": true
}

const KODEFAST_EMAIL_URL = 'https://your-domain.com/api';
const API_KEY = 'kf_em_xxxxxxxxxxxx';

async function sendTransactionalEmail(
  to: string,
  subject: string,
  htmlBody: string,
  referenceId?: string,
) {
  const response = await fetch(`${KODEFAST_EMAIL_URL}/email/send`, {
    method: 'POST',
    headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      to, subject, serviceType: 'TRANSACTIONAL', htmlBody,
      referenceType: 'NOTIFICATION', referenceId,
    }),
  });

  if (!response.ok) {
    const err = await response.json();
    throw new Error(`Email failed: ${err.code} - ${err.error}`);
  }

  const result = await response.json();
  return result.messageId; // use to track delivery status
}

await sendTransactionalEmail(
  'user@example.com',
  'Order Confirmed',
  '
Order #12345 Confirmed
Thank you!
',
  'ORDER-12345',
);

import requests

KODEFAST_EMAIL_URL = "https://your-domain.com/api"
API_KEY = "kf_em_xxxxxxxxxxxx"

def send_email(to, subject, html_body, service_type="TRANSACTIONAL"):
    response = requests.post(
        f"{KODEFAST_EMAIL_URL}/email/send",
        headers={"x-api-key": API_KEY, "Content-Type": "application/json"},
        json={"to": to, "subject": subject, "serviceType": service_type, "htmlBody": html_body},
    )
    response.raise_for_status()
    return response.json()["messageId"]

message_id = send_email(
    to="user@example.com",
    subject="Your Login OTP: 483921",
    html_body="
Your OTP is: 483921
Expires in 5 minutes.
",
    service_type="OTP",
)
print(f"Queued: {message_id}")

import org.springframework.http.*;
import org.springframework.web.client.RestTemplate;
import java.util.Map;

public class KodefastEmailClient {
    private static final String BASE_URL = "https://your-domain.com/api";
    private final String apiKey;
    private final RestTemplate restTemplate = new RestTemplate();

    public KodefastEmailClient(String apiKey) { this.apiKey = apiKey; }

    public String sendEmail(String to, String subject, String htmlBody, String serviceType) {
        HttpHeaders headers = new HttpHeaders();
        headers.set("x-api-key", apiKey);
        headers.setContentType(MediaType.APPLICATION_JSON);

        Map body = Map.of(
            "to", to, "subject", subject, "serviceType", serviceType, "htmlBody", htmlBody
        );

        ResponseEntity

function sendKodefastEmail(string $to, string $subject, string $htmlBody): string {
    $data = json_encode([
        'to' => $to, 'subject' => $subject,
        'serviceType' => 'TRANSACTIONAL', 'htmlBody' => $htmlBody,
    ]);

    $ch = curl_init('https://your-domain.com/api/email/send');
    curl_setopt_array($ch, [
        CURLOPT_POST => true, CURLOPT_POSTFIELDS => $data,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['x-api-key: kf_em_xxxxxxxxxxxx', 'Content-Type: application/json'],
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 202) throw new Exception("Email send failed: " . $response);
    return json_decode($response, true)['messageId'];
}

using System.Net.Http;
using System.Text;
using System.Text.Json;

public class KodefastEmailClient {
    private readonly HttpClient _client;
    private const string BaseUrl = "https://your-domain.com/api";

    public KodefastEmailClient(string apiKey) {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("x-api-key", apiKey);
    }

    public async Task SendEmailAsync(string to, string subject, string htmlBody, string serviceType = "TRANSACTIONAL") {
        var payload = new { to, subject, serviceType, htmlBody };
        var content = new StringContent(JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
        var response = await _client.PostAsync($"{BaseUrl}/email/send", content);
        response.EnsureSuccessStatusCode();
        var result = JsonSerializer.Deserialize(await response.Content.ReadAsStringAsync());
        return result.GetProperty("messageId").GetString()!;
    }
}

curl -X POST https://your-domain.com/api/email/send \
  -H "x-api-key: kf_em_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "subject": "Test Email",
    "serviceType": "TRANSACTIONAL",
    "htmlBody": "
Hello!
This is a test email from Kodefast.
"
  }'