Skip to content
Mailgun Inspect/API Documentation/
/
Create an Image Validatio...

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

Create an Image Validation Test

Request

Create an image validation test.

Security
basicAuth
Bodyapplication/jsonrequired
linksArray of strings
curl -i -X POST \
  -u <username>:<password> \
  https://api.mailgun.net/v1/inspect/images \
  -H 'Content-Type: application/json' \
  -d '{
    "links": [
      "string"
    ]
  }'

Responses

A 200 response

Bodyapplication/json
metaobject or null
itemsobject(github.com-mailgun-inspect-internal-imagevalidation-CreateResource)
Response
application/json
{
  "meta": {
    "status": "Processing"
  },
  "items": {
    "id": "67a654ba0f53254b9fdca3e2",
    "links": { … }
  }
}

Create an Image Validation Test by HTML

Request

Create an image validation test with HTML

Security
basicAuth
Bodyapplication/jsonrequired
htmlstring
urlstring
mimestring
transfer_encodingstring
charsetstring
curl -i -X POST \
  -u <username>:<password> \
  https://api.mailgun.net/v1/inspect/images/html-validate \
  -H 'Content-Type: application/json' \
  -d '{
    "html": "string",
    "url": "string",
    "mime": "string",
    "transfer_encoding": "string",
    "charset": "string"
  }'

Responses

A 200 response

Bodyapplication/json
metaobject or null
itemsobject(github.com-mailgun-inspect-internal-imagevalidation-CreateResource)
Response
application/json
{
  "meta": {
    "status": "Complete"
  },
  "items": {
    "id": "67b625524b911fa30a4d7858",
    "links": { … }
  }
}

Create an Image Validation Test by Image Upload

Request

Create an image validation test by image upload

Security
basicAuth
Bodyapplication/jsonrequired
imagestring(binary)
curl -i -X POST \
  -u <username>:<password> \
  https://api.mailgun.net/v1/inspect/images/upload \
  -H 'Content-Type: application/json' \
  -d '{
    "image": "string"
  }'

Responses

A 200 response

Bodyapplication/json
metaobject or null
itemsgithub.com-mailgun-inspect-internal-imagevalidation-ImageValidation (object) or null
Any of:
Response
application/json
{
  "meta": {
    "status": "Complete"
  },
  "items": {
    "id": "67b629564b911fa30a4d7873",
    "images": [ … ]
  }
}

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