# Create Spam Test (V1)

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.

Endpoint: POST /v1/inspect/spam
Version: 1.0.0
Security: basicAuth

## Request fields (application/json):

  - `subject` (string, required)

  - `html` (string, required)

  - `from_name` (string | null)

  - `sending_ip` (string | null)

  - `region` (string | null)

## Response 201 fields (application/json):

  - `meta` (object, required)

  - `meta.request_id` (string, required)

  - `meta.timestamp` (string, required)

  - `meta.count` (integer | null)

  - `item` (object, required)

  - `item.id` (string, required)

  - `item.status` (string, required)

  - `item.subject` (string, required)

  - `item.sending_ip` (string | null)

  - `item.region` (string, required)

  - `item.results` (any)

  - `item.results.b2c` (object, required)

  - `item.results.b2c.passed` (integer, required)

  - `item.results.b2c.failed` (integer, required)

  - `item.results.b2c.pending` (integer, required)

  - `item.results.b2c.results` (array, required)

  - `item.results.b2c.results.esp` (string, required)

  - `item.results.b2c.results.display_name` (string, required)

  - `item.results.b2c.results.status` (string, required)

  - `item.results.b2c.results.placement` (string, required)

  - `item.results.b2c.results.folder` (string)
    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.
    Enum: "primary", "promotions", "social", "updates", "forums", "spam"

  - `item.failure_reason` (string | null)

  - `item.created_at` (string, required)

  - `item.updated_at` (string, required)

  - `links` (object, required)

  - `links.self` (string, required)

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message

## Response 401 fields (application/json):

  - `message` (string, required)
    Response message