---
title: "Send Test Email"
method: POST
path: "/v1/emails/test/send"
tags: ["Emails"]
---

# Send Test Email

`POST /v1/emails/test/send`

Send a test email to one address. Use emailId for a specific generated email, especially emails inside a series. conversationId remains supported for single-email conversations. Requires API key with email:send permission.

## Request body

- union
  - object
    - `emailId` string, required — Email ID to test-send. Recommended for generated emails and required for series slots.
    - `conversationId` string — Single-email conversation ID. For series, use emailId.
    - `to` string, email, required — Recipient email address
  - object
    - `emailId` string — Email ID to test-send. Recommended for generated emails and required for series slots.
    - `conversationId` string, required — Single-email conversation ID. For series, use emailId.
    - `to` string, email, required — Recipient email address

## Response `200`

Test email sent successfully

- ApiResponseTestEmailSent
  - `success` boolean, required
  - `data` object, nullable
    - `messageId` string, required — Message ID from the email service
    - `conversationId` string, required — The conversation ID that was used
    - `sentTo` string, email, required — Recipient email address
    - `sentAt` string, date-time, required — Timestamp when the email was sent
    - `subject` string, required — The subject line that was sent
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden - Missing required permissions or access denied
- `404` — Resource not found

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/3f3dba69574b/schema)