---
title: "Create Spam Test (V1)"
method: POST
path: "/v1/inspect/spam"
tags: ["Spam Testing"]
---

# Create Spam Test (V1)

`POST /v1/inspect/spam`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/inspect/spam`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/inspect/spam/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Request body

- GithubComMailgunInspectInternalSpamCreateSpamTestV1Request
  - `subject` string, required
  - `html` string, required
  - `from_name` string, nullable
  - `sending_ip` string, nullable
  - `region` string, nullable

## Response `201`

A 201 response

- GithubComMailgunInspectInternalSpamSpamTestItemResponse
  - `meta` GithubComMailgunInspectInternalSpamResponseMeta, required
    - `request_id` string, required
    - `timestamp` string, required
    - `count` integer, nullable
  - `item` GithubComMailgunInspectInternalSpamSpamTestResource, required
    - `id` string, required
    - `status` string, required
    - `subject` string, required
    - `sending_ip` string, nullable
    - `region` string, required
    - `results` GithubComMailgunInspectInternalSpamSpamTestResults
      - `b2c` GithubComMailgunInspectInternalSpamESPCategoryResults, required
        - `passed` integer, required
        - `failed` integer, required
        - `pending` integer, required
        - `results` GithubComMailgunInspectInternalSpamESPResult[], required
          - `esp` string, required
          - `display_name` string, required
          - `status` string, required
          - `placement` string, required
          - `folder` 'primary' | 'promotions' | 'social' | 'updates' | 'forums' | 'spam': Gmail tab the delivered message landed in, reported for Gmail and Google Workspace only. Omitted for every other ESP and while the seed is pending or missing.
      - `b2b` GithubComMailgunInspectInternalSpamESPCategoryResults, required
        - `passed` integer, required
        - `failed` integer, required
        - `pending` integer, required
        - `results` GithubComMailgunInspectInternalSpamESPResult[], required
          - `esp` string, required
          - `display_name` string, required
          - `status` string, required
          - `placement` string, required
          - `folder` 'primary' | 'promotions' | 'social' | 'updates' | 'forums' | 'spam': Gmail tab the delivered message landed in, reported for Gmail and Google Workspace only. Omitted for every other ESP and while the seed is pending or missing.
    - `failure_reason` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
  - `links` GithubComMailgunInspectInternalSpamResponseLinks, required
    - `self` string, required

## Other responses

- `400`: A 400 response
- `401`: A 401 response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)