Skip to content
/
Get Emailpreview Test Inf...

Alerts (0.0.1)

Our alerting solution is centered around two concepts: events and channels. The occurrence of an event can be configured to trigger an alert. A channel describes the delivery method for an alert. Every configured alert consists of an event type / channel pair. This level of granularity allows alerting to be configured to your exact preference.

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

https://api.mailgun.net/

EU Mailgun

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

Domains

Operations

Inbox Placement

Inbox Placement testing allows you to see the likely deliverability of your email campaigns.

Operations

Email Preview

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

Operations

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
content_checkingobject(Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestRequestContentChecking)
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
warningsArray of objects(Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Warning)
content_checkingobject(Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult)
Response
application/json
{
  "id": "gmail"
}

Get Emailpreview Test InfoDeprecated

Request

Returns test info.

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

Security
basicAuth
Path
test_idstringrequired

Test to get the content of

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

Responses

A 200 response

Bodyapplication/json
subjectstringrequired
dateinteger(int32)required
completedArray of strings
processingArray of strings
bouncedArray of strings
content_checkingobject(Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult)
Response
application/json
{
  "subject": "string",
  "date": 0,
  "completed": [
    "string"
  ],
  "processing": [
    "string"
  ],
  "bounced": [
    "string"
  ],
  "content_checking": {
    "link_validation": { … },
    "image_validation": { … },
    "accessibility": { … }
  }
}

Delete Emailpreview TestDeprecated

Request

Deletes the specified test.

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

Security
basicAuth
Path
test_idstringrequired

Test to delete

curl -i -X DELETE \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/preview/tests/{test_id}'

Responses

A 200 response

Bodyapplication/json
successbooleanrequired
Response
application/json
{
  "success": true
}

Spam Traps Monitoring

Our spam trap monitoring service surfaces how much of your email is being sent to known spam traps.

Operations

Email Health Score

Operations

IP Blocklist Monitoring

Operations

Domain Blocklist Monitoring

Blocklist Monitoring enables you to keep an eye on your reputation. Monitor your domains against our curated list of blocklist providers to make sure you aren't being blocked.

Operations

Google Postmaster Tools

This API provides access to Google Postmaster data.

Operations

Microsoft SNDS

This API provides access to Microsoft SNDS data.

Operations

Alerts

Operations