Emails

Import HTML Email (Async)

Convert existing HTML or .eml into editable Migma emails using the same HTML to Email path as Create. Requires API key with email:write. Provide html for one file or htmls (1-12). Optional instruction describes keep-as-is vs apply-brand. Returns immediately with a conversationId and pending status. Use GET /v1/projects/emails/{conversationId}/status to retrieve production HTML, screenshots, and per-email IDs. Do not send HTML to generate.

post/v1/projects/emails/import-html

Request body

projectIdstring required
htmlstring

Single HTML or .eml source. Provide html or htmls, not both.

namestring

Filename for a single html paste.

instructionstring

Natural-language conversion instruction (keep as-is vs apply brand).

languagesstring[]
visibility'private' | 'unlisted' | 'public'
generateMediaboolean

Generate AI media for missing images. Defaults to the project setting, then true.

Response

HTML import started

successboolean required
errorstring nullable

Changes

Changed in 1 of the 5 revisions of this API.1