Skip to main content
POST
Create monitor
Requires monitors:read_write permission.
string
required
Monitor name (1–255 characters)
string
required
http, tcp, dns, heartbeat, or synthetic
object
required
Type-specific configuration. See Monitors for fields per type.
integer
default:180
Check interval in seconds (minimum: 30)
integer
default:10000
Timeout in milliseconds (range: 1000–60000)
integer
default:1
Minutes of consecutive failures before marking down (HTTP, TCP, DNS, heartbeat)
integer
default:3
Minutes of consecutive successes before marking recovered (HTTP, TCP, DNS, heartbeat)
integer
default:3
Consecutive failures before marking down (synthetic monitors only, range: 1–10)
integer
default:1
Consecutive passes before marking recovered (synthetic monitors only, range: 1–10)
boolean
default:true
Whether the monitor is active
string[]
List of alert channel IDs to attach. If omitted, channels with default_for_new_monitors are linked automatically.