---
title: "Send a preview of an email message"
method: POST
path: "/v1/email-messages/{emailMessageId}/preview"
tags: ["Email messages"]
---

# Send a preview of an email message

`POST /v1/email-messages/{emailMessageId}/preview`

Send a test preview of an email message to one or more addresses. The accepted variable fields depend on the parent's type - campaign previews accept `contactProperties`, workflow previews accept `contactProperties` and `eventProperties`, and transactional previews accept `dataVariables`. Supplying a field the parent cannot reference is rejected with 400.

## Request body

- EmailMessagePreviewRequest
  - `emails` string[], required — One or more addresses to send the preview to.
  - `contactProperties` object — Contact property values to render. Accepted for campaign and workflow previews.
  - `eventProperties` object — Event property values to render. Accepted for workflow previews only.
  - `dataVariables` object — Transactional data variables to render. Accepted for transactional previews only.

## Response `200`

Preview scheduled.

- EmailMessagePreviewResponse
  - `id` string, required — The ID of the email message the preview was sent for.

## Other responses

- `400` — Invalid request body, or a variable field the parent cannot reference.
- `401` — Invalid API key or content API not enabled for this team.
- `404` — Email message not found.
- `405` — Wrong HTTP request method.
- `429` — The daily preview limit was reached.

---

[API](https://skmtc.net/loops/apis/loops-openapi-spec.md) · [All operations](https://skmtc.net/loops/apis/loops-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loops/loops-openapi-spec/versions/96c4b50b8b95/schema)