---
canonical_url: "https://docs.composio.dev/toolkits/cronly"
markdown_url: "https://docs.composio.dev/toolkits/cronly.md"
product: "platform"
version: null
last_updated: null
---

# Cronly

Cronly monitors cron jobs, SSL certificates, servers, and crontab backups and reports operational alerts.

- **Category:** server monitoring
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `CRONLY`
- **Version:** 00000000_00

## Tools

### Create Certificate Monitor

**Slug:** `CRONLY_CREATE_CERTIFICATE`

Create an SSL/TLS certificate-expiry monitor for a hostname and port.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `port` | integer | No | TLS port to check, from 1 to 65535. |
| `hostname` | string | Yes | Resolvable hostname whose TLS certificate Cronly should monitor. Do not include a URL scheme, port, or path. |
| `project_id` | integer | No | Optional positive numeric project ID to associate with the certificate monitor. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Monitor

**Slug:** `CRONLY_CREATE_MONITOR`

Create a cron-job heartbeat monitor and return its ID and sensitive pulse token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Human-readable monitor name. |
| `duration` | integer | Yes | Expected completion window in minutes; must be positive. |
| `schedule` | string | Yes | Five-field cron expression describing the expected run schedule. |
| `timezone` | string | Yes | IANA timezone used to evaluate the schedule. |
| `project_id` | integer | No | Optional positive numeric project ID to associate with the monitor. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project

**Slug:** `CRONLY_CREATE_PROJECT`

Create a project for organizing Cronly monitors and certificate checks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Non-empty project name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Certificate Monitor

**Slug:** `CRONLY_DELETE_CERTIFICATE`

Permanently delete an SSL/TLS certificate monitor by numeric ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `certificate_id` | integer | Yes | Positive numeric ID of the certificate monitor to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Monitor

**Slug:** `CRONLY_DELETE_MONITOR`

Permanently delete a cron-job monitor by numeric ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `monitor_id` | integer | Yes | Positive numeric ID of the monitor to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Project

**Slug:** `CRONLY_DELETE_PROJECT`

Permanently delete a Cronly project by numeric ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | integer | Yes | Positive numeric ID of the project to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company

**Slug:** `CRONLY_GET_COMPANY`

Return safe organization, timezone, and subscription-summary fields for the connected Cronly account without exposing billing or integration secrets.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource

**Slug:** `CRONLY_GET_RESOURCE`

Get one monitor, project, certificate, user, server, or backup by its resource identity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | No | Server account username. Required only when resource_type is backup. |
| `resource_id` | string | Yes | Positive numeric ID for a monitor, project, certificate, user, or server; configured server identifier for a backup. |
| `resource_type` | string ("monitor" | "project" | "certificate" | "user" | "server" | "backup") | Yes | The kind of Cronly resource to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resources

**Slug:** `CRONLY_LIST_RESOURCES`

List notifications, monitors, projects, certificates, users, servers, or backups. Notifications return one page with a continuation cursor; other resource types return their complete arrays.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per_page` | integer | No | Notifications per page. Used only when resource_type is notifications; defaults to 10. |
| `next_cursor` | string | No | Continuation cursor from a previous notifications response. Omit on the first page and for every other resource type. |
| `resource_type` | string ("notifications" | "monitors" | "projects" | "certificates" | "users" | "servers" | "backups") | Yes | The kind of Cronly resource to list: notifications, monitors, projects, certificates, users, servers, or backups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Pulse Monitor

**Slug:** `CRONLY_PULSE_MONITOR`

Record a successful heartbeat for a monitor using its sensitive pulse token. This changes monitor run state even though Cronly exposes it as GET.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pulse_token` | string | Yes | Sensitive per-monitor pulse token returned by monitor creation or retrieval. Send it only to this pulse operation; never log, display, or share it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |