Create Checkly API checks and configure alert channels via the API
domain: www.checklyhq.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain a Checkly API key from Account Settings > API Keys and note your Account ID from the same page
Create an API check via POST to 'https://api.checklyhq.com/v1/checks' with 'Authorization: Bearer YOUR_KEY' and 'X-Checkly-Account: YOUR_ACCOUNT_ID' headers
Construct the request body with 'checkType': 'API', 'name', 'activated': true, 'frequency' (check interval in minutes), 'request' object containing 'url', 'method', 'headers', 'body', and 'assertions' array
Define assertions in the 'assertions' array as objects with 'source' (e.g. 'STATUS_CODE', 'JSON_BODY', 'RESPONSE_TIME'), 'comparison' ('EQUALS', 'LESS_THAN', etc.), and 'target' value
Create an alert channel via POST to '/v1/alert-channels' with type-specific config (e.g. 'SLACK' with webhook URL, 'EMAIL' with address), then link it to the check via 'alertChannelSubscriptions'
Known gotchas
The 'X-Checkly-Account' header is required on every request in addition to the Bearer token; omitting it returns a 401 or 403 even with a valid API key
Check frequency options are limited to specific values (e.g. 1, 5, 10, 15, 30, 60 minutes); supplying an arbitrary integer returns a validation error rather than rounding to the nearest valid interval
Alert channels and checks are linked via subscriptions, not inline — creating a channel does not automatically alert on any check; the subscription must be explicitly created as a separate step
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?