# Send Transactional Email

POST /api/v2/projects/{projectId}/transactional-emails

Sends caller-provided HTML to one recipient using a verified project domain. The returned ID identifies the send in the transactional email log.

## Request

- projectId: string, path, required
- from: string, required — Sender address on a verified project domain.
- html: string, required — The complete HTML to send, generated by your application.
- subject: string, required
- to: string, required — One recipient email address.
- category: string — Optional label for filtering sends, such as password-reset.
- fromName: string
- idempotencyKey: string — Reuse the same key and body when retrying one send.
- text: string — Optional plain-text alternative.

## Response

- 200: Successful response
  - id: string, required
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 500: Internal server error
