Skip to content
Mailgun Inspect/API Documentation/
/
List Emailpreview Tests

Email Preview API (1.0.0)

Mailgun Email Preview service with RESTful JSON HTTP API for providing email previews.

Download OpenAPI description
openapi-final.json
openapi-final.yaml
Languages
Servers
US Mailgun

https://api.mailgun.net/

EU Mailgun

https://api.eu.mailgun.net/

Image Validation

The Image Validation API processes image URLs or uploads to provide comprehensive details such as dimensions, type, file size, and format, reports frame count, animation duration, color depth, and transparency for GIFs, and include image optimization capabilities.

Operations

Accessibility

The Accessibility API evaluates HTML emails against WCAG standards, providing a clear pass/fail assessment to ensure compliance with accessibility guidelines.

Operations

Code Analysis

The Code Analysis API analyzes HTML email content to detect CSS features and provides comprehensive compatibility reports across major email clients, including support statistics, version-specific compatibility data, and detailed feature breakdowns to ensure optimal email rendering.

Operations

Email Preview

This API provides functionality to create and manage email preview tests, as well as create shareable links.

Operations

Returns PreviewShare record by UUID.

Request

Security
basicAuth
Path
idstringrequired

UUID to get

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/preview/sharing/public/{id}'

Responses

A 200 response

Bodyapplication/json
subjectstringrequired
dateinteger(int32)required
resultsArray of objects(github.com-mailgun-emailpreview-clients-preview-TestResult)required
results[].​idstring
results[].​display_namestring
results[].​clientstring
results[].​osstring
results[].​categorystring
results[].​browserstring
results[].​screenshotsobject
results[].​thumbnailstring
results[].​full_thumbnailstring
results[].​statusstring
results[].​status_detailsobject or null
Response
application/json
{
  "subject": "some test",
  "date": 1,
  "results": []
}

List Emailpreview TestsDeprecated

Request

Returns a list of email preview tests.

WARNING: This endpoint is deprecated in favor of our V2 endpoint.

Security
basicAuth
curl -i -X GET \
  -u <username>:<password> \
  https://api.mailgun.net/v1/preview/tests

Responses

A 200 response

Bodyapplication/jsonArray [
idstring
dateinteger(int32)
typestring
subjectstring
headersobject
]
Response
application/json
[
  {
    "id": "",
    "date": 0,
    "type": "",
    "subject": "",
    "headers": { … }
  }
]

Create Emailpreview TestDeprecated

Request

Creates a new email preview test.

WARNING: This endpoint is deprecated in favor of our V2 endpoint.

Security
basicAuth
Bodyapplication/jsonrequired
subjectstringrequired
htmlstring
mimestring
urlstring
transfer_encodingstring
charsetstring
reference_idstring
customer_idstring
clientsArray of strings
image_blockingboolean
headersobject
spamobject or null
content_checkingobject(github.com-mailgun-emailpreview-clients-preview-TestRequestContentChecking)
user_idstring
folder_idstring
project_namestring
curl -i -X POST \
  -u <username>:<password> \
  https://api.mailgun.net/v1/preview/tests \
  -H 'Content-Type: application/json' \
  -d '{
    "subject": "some subject",
    "url": "https://example.com",
    "content_checking": {}
  }'

Responses

A 200 response

Bodyapplication/json
idstring
reference_idstring
customer_idstring
spamobject or null
warningsArray of objects(github.com-mailgun-emailpreview-clients-preview-Warning)
content_checkinggithub.com-mailgun-emailpreview-clients-preview-ContentCheckingResult (object) or null
Any of:
Response
application/json
{
  "id": "gmail"
}