Automated tests run a spam test on a recurring schedule (every X days or weeks) so you can monitor inbox placement over time without triggering each test manually.

Before you can create an automated test, the target account must be connected to MailReach. If the account is only used for automated tests and not for warming/monitoring, set spamchecker_only: true when connecting it — no warming seat is charged in that case.

Typical workflow:

1. Connect the account via POST /v1/imap_auth (or the Email Workspaces endpoints) with spamchecker_only: true if it is dedicated to spam tests.
2. Create the automated test with POST /v1/automated_tests, passing the account_id.
3. Configure the schedule with POST /v1/automated_tests/{id} (repeat period, hour, time zone, audience) and POST /v1/automated_tests/{id}/runs (weekdays).
4. Trigger a run on demand — optional — with POST /v1/automated_tests/{id}/run_now.