Create a monitor
Creates a monitor through the same path as the dashboard wizard: product-default criteria (going offline auto-declares an incident that auto-resolves on recovery), initial Operational state, plan limits enforced. Website/API/External Status Page take url; Ping/IP/Port/DNS/SSL Certificate/Domain take host; Manual and Incoming Request/Email take no target. Synthetic/script, SNMP and Server monitors must be created in the dashboard. Send an Idempotency-Key header to make retries safe.
Authorization
bearerAuth An uptimely_live_ project API key (Settings → API Keys).
In: header
Header Parameters
Optional client-generated key (1-255 visible ASCII characters; a UUID works) making this POST safely retryable. Retrying with the SAME key and byte-identical body within 24h replays the stored first response. The same key with a different body answers 422 idempotency_key_reused; a retry racing the first execution answers 409 idempotency_in_progress. Omitting the header executes normally with no idempotency guarantee.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/monitors" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "monitor_type": "string" }'{ "id": "string", "slug": "string", "name": "string", "monitor_type": "string"}