Create a spam test

​

Starts a new spam test. One spam check credit is consumed per test.

Running a spam test is a 3-step workflow:

  1. Create the spam test — call this endpoint. The response returns a tracking identifier (public_full_id) and the seedlist recipients under results[].email.
  2. Send your email — from your own sending system, send the message you want to test to every address in results[].email. Include the public_full_id somewhere in the message body so MailReach can match inbound copies back to this test.
  3. Retrieve the results — poll GET /v1/spam_tests/{public_id} to fetch inbox placement, blacklists, authentication and content analysis.

Warning: email sending is handled on your side. MailReach does not send the test email for you — this endpoint only prepares the test and returns the list of recipients to send to.

Body·
required
application/json

Create a spam test

  • seedlist
    Type: integerFormat: int32enum

    Seedlist identifier used for this test. One of 1, 2, 3 or 4.

    values
    • 1
    • 2
    • 3
    • 4
Responses
  • application/json
  • application/json
Request Example for post/v1/spam_tests
curl http://api.mailreach.co/api/v1/spam_tests \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: YOUR_SECRET_TOKEN' \
  --data '{
  "seedlist": 1
}'

{
  "public_full_id": "mlrch-c7a47e3e94e98b6fd78d60a",
  "public_id": "c7a47e3e94e98b6fd78d60a",
  "results": [
    {
      "id": 6,
      "email": "siobhan@reachsecret.com",
      "desc": "Google Workspace with smart features",
      "first_name": "Siobhan",
      "provider": "gmail",
      "received_in": "INBOX",
      "raw_headers": "string"
    }
  ],
  "paid": true,
  "created_at": "2026-04-24T12:09:25.365Z",
  "first_message_content": "string",
  "test_type": "btob",
  "completed": false,
  "score": 5.7,
  "btob_score": 10,
  "btoc_score": 0,
  "final_score": 10,
  "analysis_results": "string",
  "domain": "string",
  "summary": {
    "INBOX": 16
  },
  "tld": "string",
  "blacklist_links": [
    "string"
  ],
  "blacklist_sending_ip": [
    "string"
  ],
  "sending_provider": "google.com",
  "sending_reverse_dns_value": "mail-sor-f41.google.com",
  "automated": false,
  "automated_test_id": 8,
  "spam": false,
  "seedlist": 1,
  "is_warming": false,
  "autofix_triggered": false,
  "autofix_completed": false,
  "account": "string"
}

The newly created spam test, with seedlist recipients under results