Create monitor
Creating with notifyWebhook: true and a webhookUrl enables HMAC-signed webhook delivery and returns the signing secret (monitor.webhookSecret) in this response. Returned only once. Store it securely; it cannot be retrieved later. To recover from a lost secret, rotate. All subsequent reads expose only webhookSecretSet and webhookSecretHint. Supports the Idempotency-Key header.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Display name (1-100 characters). Required on create.
1 - 100Kebab-case Lucide icon name. Default "eye".
Dashboard palette color name. Default "blue"; the valid names are returned as colors[] on GET /v1/monitors.
Email recipients for alert delivery. Default [].
Delivery cadence. Default realtime. Values: realtime (as analysis completes), hourly (hourly digest), daily (daily digest). Free-tier email delivery is coerced to daily regardless of the value sent.
realtime, hourly, daily Digest day of week. Default "monday". Consulted only by weekly digests, which are dashboard-configured today; inert for API-set frequencies.
Digest send hour as HH:MM (account timezone). Default "09:00". Applies to daily digests.
Enable HMAC-signed webhook delivery (paid plans). When enabled together with webhookUrl, the response returns the signing secret (monitor.webhookSecret) exactly once. PATCHing true also re-enables an auto-disabled webhook and resets its failure counter.
Destination URL for webhook alert deliveries.
Enable Slack delivery. Requires a Slack integration connected in the dashboard.
Slack integration id from the dashboard OAuth flow.
Slack channel id to deliver to.
Paused monitors accept config changes but do not deliver; alerts that would have fired are not queued.
Dashboard display state.
Dashboard sort position.