---
title: "Send raw HTML email"
method: POST
path: "/api/email/send-raw"
tags: ["Client"]
---

# Send raw HTML email

`POST /api/email/send-raw`

Send a custom HTML email to one or more recipients. Requires user authentication.

## Request body

- SendRawEmailRequest
  - `to` union, required — Recipient email address(es) - maximum 50 recipients
    - string, email — Single recipient email address
    - string[] — Multiple recipient email addresses (max 50)
  - `subject` string, required — Email subject line
  - `html` string, required — HTML content of the email body
  - `cc` union — Carbon copy recipient(s) - maximum 50 recipients
    - string, email — Single CC recipient email address
    - string[] — Multiple CC recipient email addresses (max 50)
  - `bcc` union — Blind carbon copy recipient(s) - maximum 50 recipients
    - string, email — Single BCC recipient email address
    - string[] — Multiple BCC recipient email addresses (max 50)
  - `from` string — Custom sender name (uses default if not provided)
  - `replyTo` string, email — Reply-to email address

## Response `200`

Email sent successfully

- SendEmailResponse — Empty object on success - extend with optional fields later if needed

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - requires authentication
- `403` — Forbidden - authentication required
- `500` — Email provider error

---

[API](https://skmtc.net/insforge/apis/insforge-authentication-api.md) · [All operations](https://skmtc.net/insforge/apis/insforge-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insforge/insforge-authentication-api/versions/a935bb49f932/schema)