Getting Started

Set up your first cron job monitor in under 5 minutes.

1. Create a monitor

Log in to your crond.io dashboard and click New Monitor. Give it a name and configure its expected schedule using a cron expression or a simple period (e.g. every 60 seconds).

Each monitor gets a unique ping URL in the format:

https://crond.io/ping/{uuid}

2. Add a ping to your cron job

After your job runs successfully, send a GET or POST request to the ping URL. The simplest approach with curl:

# In your crontab
0 2 * * * /usr/local/bin/backup.sh && curl -s https://crond.io/ping/YOUR-UUID

That's it — crond.io will now alert you if the ping stops arriving.

3. Report failures explicitly

For more precise failure detection, POST to the /fail endpoint when your job encounters an error:

curl -X POST https://crond.io/ping/YOUR-UUID/fail \
  -H "Content-Type: application/json" \
  -d '{"message": "Database connection failed"}'

4. Configure alerts

In your monitor settings, add your email address for instant notifications. Pro users can also add webhook URLs to integrate with Slack, PagerDuty, or any HTTP endpoint.

Next steps

Install the Agent CLI for richer reporting
Explore the REST API for programmatic management
Set up webhooks for custom alert routing