API documentation

Authentication

Create a key in Settings → API keys. Keys start with cr_live_ and are shown once. Send the key in one of three ways:

MethodInTypeExample

AuthorizationheaderBearerAuthorization: Bearer cr_live_…

X-API-KeyheaderstringX-API-Key: cr_live_…

api_keyquerystring?api_key=cr_live_… (avoid: URLs end up in logs)

Scopes

Read & write keys can do everything below. Read only keys can make GET and HEAD requests; anything else returns 403 with {"error": "This API key is read-only"}.

Requests and responses

Send JSON bodies with Content-Type: application/json. Single resources come back as {"data": {…}}, lists as {"data": […], "meta": {"total", "page", "per_page"}}. Errors are {"error": "…"}; validation errors add "errors": {"field": "message"} with status 422.

Resources are addressed by their token. Creating beyond your plan’s limit returns 403.

Try it

curl https://app.cronly.net/api/v1/heartbeats \
  -H "Authorization: Bearer $CRONLY_API_KEY"

List heartbeats

GET/api/v1/heartbeats

A heartbeat expects a ping from your job. If no ping arrives on schedule plus the grace period, it alerts.

ParameterInTypeDescription

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/heartbeats \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 42,
            "token": "Xq3n8LmA2pTz",
            "name": "nightly-backup",
            "interval_minutes": null,
            "cron_expression": "0 3 * * *",
            "timezone": "Europe/Berlin",
            "grace_period_minutes": 15,
            "status": "ok",
            "last_ping_at": null,
            "created_at": "2026-11-10 08:00:00"
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

Create a heartbeat

POST/api/v1/heartbeats

A heartbeat expects a ping from your job. If no ping arrives on schedule plus the grace period, it alerts.

ParameterInTypeDescription

namerequiredbodystring2–100 characters

interval_minutesbodyinteger1–43200. Required unless you send cron_expression

cron_expressionbodystringStandard 5-field cron, e.g. 30 7 * * 1-5

timezonebodystringIANA timezone for the cron, default UTC

grace_period_minutesbodyinteger1–1440, default 5

Request · curl

curl -X POST https://app.cronly.net/api/v1/heartbeats \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"nightly-backup","cron_expression":"0 3 * * *","timezone":"Europe/Berlin","grace_period_minutes":15}'

Response · 201

{
    "data": {
        "id": 42,
        "token": "Xq3n8LmA2pTz",
        "name": "nightly-backup",
        "interval_minutes": null,
        "cron_expression": "0 3 * * *",
        "timezone": "Europe/Berlin",
        "grace_period_minutes": 15,
        "status": "ok",
        "last_ping_at": null,
        "created_at": "2026-11-10 08:00:00"
    }
}

Status codes

201Created

401Missing or invalid API key

403Read-only key, plan limit reached, or account suspended

422Validation failed: see errors for each field

Get a heartbeat with its last 10 pings

GET/api/v1/heartbeats/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl https://app.cronly.net/api/v1/heartbeats/Xq3n8LmA2pTz \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": {
        "id": 42,
        "token": "Xq3n8LmA2pTz",
        "name": "nightly-backup",
        "interval_minutes": null,
        "cron_expression": "0 3 * * *",
        "timezone": "Europe/Berlin",
        "grace_period_minutes": 15,
        "status": "ok",
        "last_ping_at": null,
        "created_at": "2026-11-10 08:00:00",
        "recent_pings": [
            {
                "id": 9012,
                "heartbeat_id": 42,
                "ip": "203.0.113.7",
                "user_agent": "curl/8.5.0",
                "payload": null,
                "late_seconds": 0,
                "created_at": "2026-11-10 03:00:04"
            }
        ]
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

Update a heartbeat

PUT/api/v1/heartbeats/{token}

Send only the fields you want to change.

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

namebodystring2–100 characters

interval_minutesbodyinteger1–43200. Required unless you send cron_expression

cron_expressionbodystringStandard 5-field cron, e.g. 30 7 * * 1-5

timezonebodystringIANA timezone for the cron, default UTC

grace_period_minutesbodyinteger1–1440, default 5

Request · curl

curl -X PUT https://app.cronly.net/api/v1/heartbeats/Xq3n8LmA2pTz \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"nightly-backup"}'

Response · 200

{
    "data": {
        "id": 42,
        "token": "Xq3n8LmA2pTz",
        "name": "nightly-backup",
        "interval_minutes": null,
        "cron_expression": "0 3 * * *",
        "timezone": "Europe/Berlin",
        "grace_period_minutes": 15,
        "status": "ok",
        "last_ping_at": null,
        "created_at": "2026-11-10 08:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

422Validation failed: see errors for each field

Delete a heartbeat and its pings

DELETE/api/v1/heartbeats/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl -X DELETE https://app.cronly.net/api/v1/heartbeats/Xq3n8LmA2pTz \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "message": "Deleted successfully"
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

List webhook inboxes

GET/api/v1/webhooks

An inbox captures every request sent to its URL and can forward each one to your own endpoint.

ParameterInTypeDescription

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/webhooks \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 7,
            "token": "KO3p1FluZcrQ",
            "name": "stripe-events",
            "forward_url": "https://api.example.com/stripe",
            "auto_retry": 1,
            "retry_count": 3,
            "is_paused": 0,
            "created_at": "2026-11-10 08:00:00"
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

Create a webhook inbox

POST/api/v1/webhooks

An inbox captures every request sent to its URL and can forward each one to your own endpoint.

ParameterInTypeDescription

namerequiredbodystring2–100 characters

forward_urlbodystringPublic http(s) URL to forward each request to

auto_retrybodybooleanRetry failed forwards, default false

retry_countbodyintegerForward retries, 0–5

Request · curl

curl -X POST https://app.cronly.net/api/v1/webhooks \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"stripe-events","forward_url":"https://api.example.com/stripe","auto_retry":true,"retry_count":3}'

Response · 201

{
    "data": {
        "id": 7,
        "token": "KO3p1FluZcrQ",
        "name": "stripe-events",
        "forward_url": "https://api.example.com/stripe",
        "auto_retry": 1,
        "retry_count": 3,
        "is_paused": 0,
        "created_at": "2026-11-10 08:00:00"
    }
}

Status codes

201Created

401Missing or invalid API key

403Read-only key, plan limit reached, or account suspended

422Validation failed: see errors for each field

Get a webhook inbox

GET/api/v1/webhooks/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl https://app.cronly.net/api/v1/webhooks/KO3p1FluZcrQ \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": {
        "id": 7,
        "token": "KO3p1FluZcrQ",
        "name": "stripe-events",
        "forward_url": "https://api.example.com/stripe",
        "auto_retry": 1,
        "retry_count": 3,
        "is_paused": 0,
        "created_at": "2026-11-10 08:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

Update a webhook inbox

PUT/api/v1/webhooks/{token}

Send only the fields you want to change.

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

namebodystring2–100 characters

forward_urlbodystringPublic http(s) URL to forward each request to

auto_retrybodybooleanRetry failed forwards, default false

retry_countbodyintegerForward retries, 0–5

Request · curl

curl -X PUT https://app.cronly.net/api/v1/webhooks/KO3p1FluZcrQ \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"stripe-events"}'

Response · 200

{
    "data": {
        "id": 7,
        "token": "KO3p1FluZcrQ",
        "name": "stripe-events",
        "forward_url": "https://api.example.com/stripe",
        "auto_retry": 1,
        "retry_count": 3,
        "is_paused": 0,
        "created_at": "2026-11-10 08:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

422Validation failed: see errors for each field

Delete a webhook inbox

DELETE/api/v1/webhooks/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl -X DELETE https://app.cronly.net/api/v1/webhooks/KO3p1FluZcrQ \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "message": "Deleted successfully"
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

List captured requests, newest first

GET/api/v1/webhooks/{token}/logs

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/webhooks/KO3p1FluZcrQ/logs \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 1203,
            "method": "POST",
            "headers": "{\"content-type\":\"application/json\"}",
            "body": "{\"type\":\"invoice.paid\"}",
            "query_params": "{}",
            "source_ip": "3.18.12.63",
            "forward_status": "success",
            "forward_status_code": 200,
            "forward_latency_ms": 184,
            "created_at": "2026-11-10 08:02:11"
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

List uptime monitors

GET/api/v1/uptime-monitors

HTTP, TCP, Ping and SMTP checks. A failure is re-checked before the monitor is marked down.

ParameterInTypeDescription

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/uptime-monitors \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 19,
            "token": "Cb8rmCq08bTw",
            "name": "api",
            "type": "http",
            "target": "https://api.example.com/health",
            "port": null,
            "interval_minutes": 1,
            "timeout_seconds": 10,
            "expected_code": "200",
            "keyword": null,
            "status": "up",
            "is_active": 1,
            "last_check_at": "2026-11-10 08:04:00",
            "uptime": {
                "24h": 100,
                "7d": 99.98,
                "30d": 99.95
            }
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

Create an uptime monitor

POST/api/v1/uptime-monitors

HTTP, TCP, Ping and SMTP checks. A failure is re-checked before the monitor is marked down.

ParameterInTypeDescription

namerequiredbodystring2–100 characters

typebodystringhttp (default), tcp, ping or smtp

targetrequiredbodystringURL for http, host name or IP otherwise

portbodyintegerFor tcp and smtp

interval_minutesbodyintegerMinutes between checks

timeout_secondsbodyintegerSeconds before a check fails

expected_codebodystringhttp only, e.g. 200

keywordbodystringhttp only: text the response must contain

Request · curl

curl -X POST https://app.cronly.net/api/v1/uptime-monitors \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"api","type":"http","target":"https://api.example.com/health","interval_minutes":1,"expected_code":"200"}'

Response · 201

{
    "data": {
        "id": 19,
        "token": "Cb8rmCq08bTw",
        "name": "api",
        "type": "http",
        "target": "https://api.example.com/health",
        "port": null,
        "interval_minutes": 1,
        "timeout_seconds": 10,
        "expected_code": "200",
        "keyword": null,
        "status": "up",
        "is_active": 1,
        "last_check_at": "2026-11-10 08:04:00",
        "uptime": {
            "24h": 100,
            "7d": 99.98,
            "30d": 99.95
        }
    }
}

Status codes

201Created

401Missing or invalid API key

403Read-only key, plan limit reached, or account suspended

422Validation failed: see errors for each field

Get an uptime monitor with 24 h / 7 d / 30 d uptime

GET/api/v1/uptime-monitors/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl https://app.cronly.net/api/v1/uptime-monitors/Cb8rmCq08bTw \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": {
        "id": 19,
        "token": "Cb8rmCq08bTw",
        "name": "api",
        "type": "http",
        "target": "https://api.example.com/health",
        "port": null,
        "interval_minutes": 1,
        "timeout_seconds": 10,
        "expected_code": "200",
        "keyword": null,
        "status": "up",
        "is_active": 1,
        "last_check_at": "2026-11-10 08:04:00",
        "uptime": {
            "24h": 100,
            "7d": 99.98,
            "30d": 99.95
        }
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

Update an uptime monitor

PUT/api/v1/uptime-monitors/{token}

Send only the fields you want to change.

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

namebodystring2–100 characters

typebodystringhttp (default), tcp, ping or smtp

targetbodystringURL for http, host name or IP otherwise

portbodyintegerFor tcp and smtp

interval_minutesbodyintegerMinutes between checks

timeout_secondsbodyintegerSeconds before a check fails

expected_codebodystringhttp only, e.g. 200

keywordbodystringhttp only: text the response must contain

Request · curl

curl -X PUT https://app.cronly.net/api/v1/uptime-monitors/Cb8rmCq08bTw \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"api"}'

Response · 200

{
    "data": {
        "id": 19,
        "token": "Cb8rmCq08bTw",
        "name": "api",
        "type": "http",
        "target": "https://api.example.com/health",
        "port": null,
        "interval_minutes": 1,
        "timeout_seconds": 10,
        "expected_code": "200",
        "keyword": null,
        "status": "up",
        "is_active": 1,
        "last_check_at": "2026-11-10 08:04:00",
        "uptime": {
            "24h": 100,
            "7d": 99.98,
            "30d": 99.95
        }
    }
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

422Validation failed: see errors for each field

Delete an uptime monitor

DELETE/api/v1/uptime-monitors/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl -X DELETE https://app.cronly.net/api/v1/uptime-monitors/Cb8rmCq08bTw \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "message": "Deleted successfully"
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

List SSL certificate monitors

GET/api/v1/ssl-monitors

Checked once a day. Reminders go out 30, 14, 7 and 1 days before expiry.

ParameterInTypeDescription

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/ssl-monitors \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 11,
            "token": "Tu9ru71XFzt4",
            "name": "shop",
            "domain": "shop.example.com",
            "port": 443,
            "status": "ok",
            "is_valid": 1,
            "issuer": "R11",
            "expires_at": "2027-01-28 23:59:59",
            "last_check_at": "2026-11-10 06:00:00"
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

Create an SSL certificate monitor

POST/api/v1/ssl-monitors

Checked once a day. Reminders go out 30, 14, 7 and 1 days before expiry.

ParameterInTypeDescription

namerequiredbodystring2–100 characters

domainrequiredbodystringHost name without scheme or path

portbodyintegerDefault 443

Request · curl

curl -X POST https://app.cronly.net/api/v1/ssl-monitors \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"shop","domain":"shop.example.com","port":443}'

Response · 201

{
    "data": {
        "id": 11,
        "token": "Tu9ru71XFzt4",
        "name": "shop",
        "domain": "shop.example.com",
        "port": 443,
        "status": "ok",
        "is_valid": 1,
        "issuer": "R11",
        "expires_at": "2027-01-28 23:59:59",
        "last_check_at": "2026-11-10 06:00:00"
    }
}

Status codes

201Created

401Missing or invalid API key

403Read-only key, plan limit reached, or account suspended

422Validation failed: see errors for each field

Get an SSL certificate monitor

GET/api/v1/ssl-monitors/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl https://app.cronly.net/api/v1/ssl-monitors/Tu9ru71XFzt4 \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": {
        "id": 11,
        "token": "Tu9ru71XFzt4",
        "name": "shop",
        "domain": "shop.example.com",
        "port": 443,
        "status": "ok",
        "is_valid": 1,
        "issuer": "R11",
        "expires_at": "2027-01-28 23:59:59",
        "last_check_at": "2026-11-10 06:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

Update an SSL certificate monitor

PUT/api/v1/ssl-monitors/{token}

Send only the fields you want to change.

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

namebodystring2–100 characters

domainbodystringHost name without scheme or path

portbodyintegerDefault 443

Request · curl

curl -X PUT https://app.cronly.net/api/v1/ssl-monitors/Tu9ru71XFzt4 \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"shop"}'

Response · 200

{
    "data": {
        "id": 11,
        "token": "Tu9ru71XFzt4",
        "name": "shop",
        "domain": "shop.example.com",
        "port": 443,
        "status": "ok",
        "is_valid": 1,
        "issuer": "R11",
        "expires_at": "2027-01-28 23:59:59",
        "last_check_at": "2026-11-10 06:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

422Validation failed: see errors for each field

Delete an SSL certificate monitor

DELETE/api/v1/ssl-monitors/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl -X DELETE https://app.cronly.net/api/v1/ssl-monitors/Tu9ru71XFzt4 \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "message": "Deleted successfully"
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

List domain monitors

GET/api/v1/domain-monitors

WHOIS is checked once a day. Reminders go out 30, 14, 7 and 1 days before the registration expires.

ParameterInTypeDescription

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/domain-monitors \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 13,
            "token": "8QMtCcBl3vV6",
            "name": "example.com",
            "domain": "example.com",
            "status": "ok",
            "registrar": "Example Registrar, Inc.",
            "expires_at": "2027-08-13 04:00:00",
            "last_check_at": "2026-11-10 06:00:00"
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

Create a domain monitor

POST/api/v1/domain-monitors

WHOIS is checked once a day. Reminders go out 30, 14, 7 and 1 days before the registration expires.

ParameterInTypeDescription

namerequiredbodystring2–100 characters

domainrequiredbodystringRegistered domain, e.g. example.com

Request · curl

curl -X POST https://app.cronly.net/api/v1/domain-monitors \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"example.com","domain":"example.com"}'

Response · 201

{
    "data": {
        "id": 13,
        "token": "8QMtCcBl3vV6",
        "name": "example.com",
        "domain": "example.com",
        "status": "ok",
        "registrar": "Example Registrar, Inc.",
        "expires_at": "2027-08-13 04:00:00",
        "last_check_at": "2026-11-10 06:00:00"
    }
}

Status codes

201Created

401Missing or invalid API key

403Read-only key, plan limit reached, or account suspended

422Validation failed: see errors for each field

Get a domain monitor

GET/api/v1/domain-monitors/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl https://app.cronly.net/api/v1/domain-monitors/8QMtCcBl3vV6 \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": {
        "id": 13,
        "token": "8QMtCcBl3vV6",
        "name": "example.com",
        "domain": "example.com",
        "status": "ok",
        "registrar": "Example Registrar, Inc.",
        "expires_at": "2027-08-13 04:00:00",
        "last_check_at": "2026-11-10 06:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

Update a domain monitor

PUT/api/v1/domain-monitors/{token}

Send only the fields you want to change.

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

namebodystring2–100 characters

domainbodystringRegistered domain, e.g. example.com

Request · curl

curl -X PUT https://app.cronly.net/api/v1/domain-monitors/8QMtCcBl3vV6 \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"example.com"}'

Response · 200

{
    "data": {
        "id": 13,
        "token": "8QMtCcBl3vV6",
        "name": "example.com",
        "domain": "example.com",
        "status": "ok",
        "registrar": "Example Registrar, Inc.",
        "expires_at": "2027-08-13 04:00:00",
        "last_check_at": "2026-11-10 06:00:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

422Validation failed: see errors for each field

Delete a domain monitor

DELETE/api/v1/domain-monitors/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl -X DELETE https://app.cronly.net/api/v1/domain-monitors/8QMtCcBl3vV6 \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "message": "Deleted successfully"
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

List web crons

GET/api/v1/web-crons

Cronly calls your URL on a schedule and checks the response.

ParameterInTypeDescription

pagequeryintegerPage number, default 1

per_pagequeryintegerItems per page, 1–100, default 20

Request · curl

curl https://app.cronly.net/api/v1/web-crons \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": [
        {
            "id": 5,
            "token": "wQ2dE4rT6yU8",
            "name": "warm-cache",
            "url": "https://example.com/cron/warm",
            "method": "POST",
            "cron_expression": "*/15 * * * *",
            "timezone": "UTC",
            "status": "ok",
            "is_active": 1,
            "last_run_at": "2026-11-10 08:00:00",
            "next_run_at": "2026-11-10 08:15:00"
        }
    ],
    "meta": {
        "total": 1,
        "page": 1,
        "per_page": 20
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

Create a web cron

POST/api/v1/web-crons

Cronly calls your URL on a schedule and checks the response.

ParameterInTypeDescription

namerequiredbodystring2–100 characters

urlrequiredbodystringPublic http(s) URL to call

cron_expressionrequiredbodystring5-field cron, e.g. */15 * * * *

methodbodystringGET (default), POST, PUT, PATCH, DELETE or HEAD

headersbodyobjectRequest headers

bodybodystringRequest body

timezonebodystringIANA timezone for the schedule, default UTC

timeout_secondsbodyintegerSeconds before a run fails

success_http_codesbodystringCodes that count as success, e.g. 200-299

success_keywordbodystringText the response must contain

success_regexbodystringPattern the response must match

retry_countbodyintegerRetries before a run counts as failed

Request · curl

curl -X POST https://app.cronly.net/api/v1/web-crons \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"warm-cache","url":"https://example.com/cron/warm","method":"POST","cron_expression":"*/15 * * * *","success_http_codes":"200-299"}'

Response · 201

{
    "data": {
        "id": 5,
        "token": "wQ2dE4rT6yU8",
        "name": "warm-cache",
        "url": "https://example.com/cron/warm",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "UTC",
        "status": "ok",
        "is_active": 1,
        "last_run_at": "2026-11-10 08:00:00",
        "next_run_at": "2026-11-10 08:15:00"
    }
}

Status codes

201Created

401Missing or invalid API key

403Read-only key, plan limit reached, or account suspended

422Validation failed: see errors for each field

Get a web cron

GET/api/v1/web-crons/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl https://app.cronly.net/api/v1/web-crons/wQ2dE4rT6yU8 \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "data": {
        "id": 5,
        "token": "wQ2dE4rT6yU8",
        "name": "warm-cache",
        "url": "https://example.com/cron/warm",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "UTC",
        "status": "ok",
        "is_active": 1,
        "last_run_at": "2026-11-10 08:00:00",
        "next_run_at": "2026-11-10 08:15:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Account suspended

404No resource with that token in your account

Update a web cron

PUT/api/v1/web-crons/{token}

Send only the fields you want to change.

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

namebodystring2–100 characters

urlbodystringPublic http(s) URL to call

cron_expressionbodystring5-field cron, e.g. */15 * * * *

methodbodystringGET (default), POST, PUT, PATCH, DELETE or HEAD

headersbodyobjectRequest headers

bodybodystringRequest body

timezonebodystringIANA timezone for the schedule, default UTC

timeout_secondsbodyintegerSeconds before a run fails

success_http_codesbodystringCodes that count as success, e.g. 200-299

success_keywordbodystringText the response must contain

success_regexbodystringPattern the response must match

retry_countbodyintegerRetries before a run counts as failed

Request · curl

curl -X PUT https://app.cronly.net/api/v1/web-crons/wQ2dE4rT6yU8 \
  -H "Authorization: Bearer $CRONLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"warm-cache"}'

Response · 200

{
    "data": {
        "id": 5,
        "token": "wQ2dE4rT6yU8",
        "name": "warm-cache",
        "url": "https://example.com/cron/warm",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "UTC",
        "status": "ok",
        "is_active": 1,
        "last_run_at": "2026-11-10 08:00:00",
        "next_run_at": "2026-11-10 08:15:00"
    }
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

422Validation failed: see errors for each field

Delete a web cron

DELETE/api/v1/web-crons/{token}

ParameterInTypeDescription

tokenrequiredpathstringThe resource token shown in the app and returned as token

Request · curl

curl -X DELETE https://app.cronly.net/api/v1/web-crons/wQ2dE4rT6yU8 \
  -H "Authorization: Bearer $CRONLY_API_KEY"

Response · 200

{
    "message": "Deleted successfully"
}

Status codes

200OK

401Missing or invalid API key

403Read-only key or account suspended

404No resource with that token in your account

Service health. No API key needed.

GET/api/health

Request · curl

curl https://app.cronly.net/api/health

Response · 200

{
    "status": "ok",
    "timestamp": 1762761600
}

Status codes

200OK

API reference

Authentication

Scopes

Requests and responses

List heartbeats

Status codes

Create a heartbeat

Status codes

Get a heartbeat with its last 10 pings

Status codes

Update a heartbeat

Status codes

Delete a heartbeat and its pings

Status codes

List webhook inboxes

Status codes

Create a webhook inbox

Status codes

Get a webhook inbox

Status codes

Update a webhook inbox

Status codes

Delete a webhook inbox

Status codes

List captured requests, newest first

Status codes

List uptime monitors

Status codes

Create an uptime monitor

Status codes

Get an uptime monitor with 24 h / 7 d / 30 d uptime

Status codes

Update an uptime monitor

Status codes

Delete an uptime monitor

Status codes

List SSL certificate monitors

Status codes

Create an SSL certificate monitor

Status codes

Get an SSL certificate monitor

Status codes

Update an SSL certificate monitor

Status codes

Delete an SSL certificate monitor

Status codes

List domain monitors

Status codes

Create a domain monitor

Status codes

Get a domain monitor

Status codes

Update a domain monitor

Status codes

Delete a domain monitor

Status codes

List web crons

Status codes

Create a web cron

Status codes

Get a web cron

Status codes

Update a web cron

Status codes

Delete a web cron

Status codes

Service health. No API key needed.

Status codes