spam_tests

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 POST /v1/spam_tests. 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 — the create endpoint only prepares the test and returns the list of recipients to send to.