# Create Email Preview Test V2

This call creates a new email test and submits it to our system for processing.All requests must contain a subject property and one source property (either html or url). All other properties are optional. In the following table, each property and its default value is shown. If content-checking variables (such as those for link validation, image validation, or accessibility) are set in the body of the request, the endpoint will run content-checking on the email content. The response will include an id property that should be used to request the results or trigger further processes on the email content.For enterprise customers, the response will also include the customer_id and reference_id that were submitted with the test.

Endpoint: POST /v2/preview/tests
Version: 1.0.0
Security: basicAuth

## Request fields (application/json):

  - `subject` (string, required)

  - `html` (string)

  - `mime` (string)

  - `url` (string)

  - `transfer_encoding` (string)

  - `charset` (string)

  - `reference_id` (string)

  - `customer_id` (string)

  - `clients` (array)

  - `image_blocking` (boolean)

  - `headers` (object)

  - `spam` (object,null)

  - `spam.test_method` (string)

  - `spam.from_address` (string)

  - `spam.key` (string)

  - `spam.smtp_info` (object,null)

  - `spam.smtp_info.host` (string)

  - `spam.smtp_info.port` (integer)

  - `spam.smtp_info.secure` (string)

  - `spam.smtp_info.username` (string)

  - `spam.smtp_info.password` (string)

  - `content_checking` (object)

  - `content_checking.link_validation` (boolean)

  - `content_checking.image_validation` (boolean)

  - `content_checking.accessibility` (boolean)

  - `user_id` (string)

  - `folder_id` (string)

  - `project_name` (string)

## Response 200 fields (application/json):

  - `id` (string)

  - `reference_id` (string)

  - `customer_id` (string)

  - `spam` (object,null)

  - `spam.key` (string)

  - `spam.address_list` (array)

  - `warnings` (array)

  - `warnings.name` (string)

  - `warnings.message` (string)

  - `content_checking` (any)

## Response 400 fields (application/json):

  - `Reason` (string, required)

## Response 401 fields (application/json):

  - `Reason` (string, required)

## Response 500 fields (application/json):

  - `message` (string, required)
    Response message

## Response default fields (application/json):

  - `error` (object)

  - `error.name` (string)

  - `error.message` (string)