---
title: "Create Email Preview"
method: POST
path: "/v1/emails/previews"
tags: ["Email Previews"]
---

# Create Email Preview

`POST /v1/emails/previews`

Generate email previews from HTML rendered on real devices and email clients (Gmail, Outlook, Apple Mail, mobile apps, and other supported platforms).

**💳 Credit Cost:** Each preview request costs **2 credits**.

## Request body

- object
  - `html` string, required — Email HTML content to preview
  - `subject` string — Email subject line (for display purposes)
  - `devices` string[], required — Specific devices to render on
  - `name` string — Custom name for the preview

## Response `200`

Preview creation started

- object
  - `success` boolean
  - `data` object
    - `previewId` string
    - `status` 'processing' | 'completed' | 'partial' | 'failed'
    - `name` string
    - `subject` string
    - `devices` string[]
    - `metadata` object
      - `requestedDevices` integer
      - `completedDevices` integer
      - `failedDevices` integer
      - `estimatedCompletionTime` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[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/2d06ad0e0bc3/schema)