Skip to content
Mailgun Inspect/API Documentation/
/
Create Spam Test (V1)

Create Spam Test (V1)

Request

Initiates an inbox placement test with subject and HTML provided directly in the request body. Returns immediately with status=processing; poll GET using the Retry-After interval.

Security
basicAuth
Bodyapplication/jsonrequired
subjectstringrequired
htmlstringrequired
from_namestring or null
sending_ipstring or null
regionstring or null
curl -i -X POST \
  -u '<username>:<password>' \
  https://api.mailgun.net/v1/inspect/spam \
  -H 'Content-Type: application/json' \
  -d '{
    "subject": "string",
    "html": "string",
    "from_name": "string",
    "sending_ip": "string",
    "region": "string"
  }'

Responses

A 201 response

Bodyapplication/json
metaobject(github.com-mailgun-inspect-internal-spam-ResponseMeta)required
itemobject(github.com-mailgun-inspect-internal-spam-SpamTestResource)required
Response
{
  "meta": {},
  "item": {
    "id": "67a654ba0f53254b9fdca3e2",
    "status": "processing",
    "subject": "Welcome to Mailgun",
    "region": "us1",
    "created_at": "2026-03-11T10:00:00Z",
    "updated_at": "2026-03-11T10:00:05Z"
  },
  "links": {}
}