---
title: "Create Emailpreview Test"
method: POST
path: "/v1/preview/tests"
tags: ["Email Preview"]
deprecated: true
---

# Create Emailpreview Test

`POST /v1/preview/tests`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/preview/tests`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/preview/tests/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Creates a new email preview test.<br><br>**WARNING:** _This endpoint is deprecated in favor of our [V2 endpoint](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/POST-v2-preview-tests)._

## Request body

- GithubComMailgunEmailpreviewClientsPreviewCreateTestRequest
  - `subject` string, required
  - `html` string
  - `mime` string
  - `url` string
  - `transfer_encoding` string
  - `charset` string
  - `reference_id` string
  - `customer_id` string
  - `clients` string[]
  - `image_blocking` boolean
  - `headers` object
  - `spam` object, nullable
    - `test_method` string
    - `from_address` string
    - `key` string
    - `smtp_info` object, nullable
      - `host` string
      - `port` integer
      - `secure` string
      - `username` string
      - `password` string
  - `content_checking` GithubComMailgunEmailpreviewClientsPreviewTestRequestContentChecking
    - `link_validation` boolean: Enable comprehensive link analysis
    - `image_validation` boolean: Enable comprehensive image analysis
    - `accessibility` boolean: Enable comprehensive accessibility analysis
    - `code_analysis` boolean: Enable comprehensive code analysis of the email content to detect HTML and CSS features and provides a compatibility report across major email clients.
  - `user_id` string
  - `folder_id` string
  - `project_name` string

## Response `200`

A 200 response

- GithubComMailgunEmailpreviewClientsPreviewCreateTestResponse
  - `id` string
  - `reference_id` string
  - `customer_id` string
  - `spam` object, nullable
    - `key` string
    - `address_list` string[]
  - `warnings` GithubComMailgunEmailpreviewClientsPreviewWarning[]
    - `name` string
    - `message` string
  - `content_checking` GithubComMailgunEmailpreviewClientsPreviewContentCheckingResult
    - `link_validation` GithubComMailgunEmailpreviewClientsInspectInspectDtoRepsponse
      - `items` GithubComMailgunEmailpreviewClientsInspectItem
        - `id` string
        - `links` GithubComMailgunEmailpreviewClientsInspectLinks
          - `self` string
      - `errors` GithubComMailgunEmailpreviewClientsInspectErrorDetail[]
        - `status` string
        - `title` string
        - `detail` string
    - `image_validation` GithubComMailgunEmailpreviewClientsInspectInspectDtoRepsponse
      - `items` GithubComMailgunEmailpreviewClientsInspectItem
        - `id` string
        - `links` GithubComMailgunEmailpreviewClientsInspectLinks
          - `self` string
      - `errors` GithubComMailgunEmailpreviewClientsInspectErrorDetail[]
        - `status` string
        - `title` string
        - `detail` string
    - `accessibility` GithubComMailgunEmailpreviewClientsInspectInspectDtoRepsponse
      - `items` GithubComMailgunEmailpreviewClientsInspectItem
        - `id` string
        - `links` GithubComMailgunEmailpreviewClientsInspectLinks
          - `self` string
      - `errors` GithubComMailgunEmailpreviewClientsInspectErrorDetail[]
        - `status` string
        - `title` string
        - `detail` string
    - `code_analysis` GithubComMailgunEmailpreviewClientsInspectCodeAnalysisResponse
      - `meta` object, nullable
      - `items` GithubComMailgunEmailpreviewClientsInspectCodeAnalysisItem, required
        - `id` string, required
        - `links` GithubComMailgunEmailpreviewClientsInspectLinks, required
          - `self` string

## Other responses

- `400`: A 400 response
- `401`: A 401 response
- `500`: A 500 response
- `default`: A default response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)