Email API Endpoints

Send Email

Send a single email using plain text or HTML content.

{
'Content-Type': 'application/json',
'x-api-key': 'your_api_key'
}

{
  to: string;
  subject: string;
  name: string;
  message: string; // Plain text or HTML
}

{
data?: {
    messageId: string;
    status: 'sent';
    };
error?: string;
}

Send an email using a pre-built template.

{
'Content-Type': 'application/json',
'x-api-key': 'your_api_key'
}

{
  to: string;
  from: string;
  templateId: string;
  variables: Record<string, string>;
}

{
data?: {
    messageId: string;
    status: 'sent';
    };
error?: string;
}

Test endpoint for sending emails without affecting your quota. Uses the same request/response format as /api/send-email.

Test endpoint for sending template emails without affecting your quota. Uses the same request/response format as /api/send-email-from-template.

All endpoints may return the following error responses:

{
  error: string;
  status: string;
}

Common error status codes: