ReachScore Docs
API Reference

Monitors

Scheduled monitoring for automated deliverability testing. Create monitors to run tests on a regular schedule and track trends over time.

Create a new scheduled monitor. The monitor will automatically run tests at the specified frequency.

Request Bodyrequired

namestring

Display name for the monitor

from_addressstring<email>required

Sender email address for test emails

frequencystringrequired

How often to run tests

hourlydailyweekly
alert_thresholdinteger

Score threshold for triggering alerts (0-100)

Response

idstring

Unique monitor identifier (mon_xxx)

objectstring

Always 'monitor'

namestring
from_addressstring<email>
domain_idstring
frequencystring
hourlydailyweekly
enabledboolean
alert_thresholdinteger
created_atstring<date-time>

Example Request

curl -X POST https://api.reachscore.co/v1/monitors \
  -H "Authorization: Bearer rk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Newsletter Check",
    "from_address": "newsletter@yourcompany.com",
    "frequency": "daily",
    "alert_threshold": 80
  }'

Example Response

{
  "id": "mon_4zJ9mN3pQsT5",
  "object": "monitor",
  "name": "Daily Newsletter Check",
  "from_address": "newsletter@yourcompany.com",
  "domain_id": "dom_3yH8kL2nP5qR",
  "frequency": "daily",
  "enabled": true,
  "alert_threshold": 80,
  "latest_score": null,
  "created_at": "2026-03-11T10:30:00Z"
}
Previous: DomainsNext: Webhooks