Blip
← All guides

Get a push when Healthchecks.io sees a cron job fail

Healthchecks.io already knows when a cron job stops checking in. Its Webhook integration can tell Blip too, so a down check lands on your lock screen instead of in an inbox you read later.

1

Create a Cron channel in Blip

Install the Blip iOS app, tap + to create a channel named Cron, and copy its key (it starts with blip_live_). Your webhook URL is this one, with your key in place of blip_live_xxx. It takes any JSON with a title and a body.

Blip webhook URL
https://blipnotify.com/api/v1/hooks/generic/blip_live_xxx

The key is in the URL, so keep it private. Rotate the key in the app anytime to cut off a leaked URL. Webhook URLs work during the free trial and on Pro.

2

Add a Webhook integration in Healthchecks

In Healthchecks.io, open Integrations and add a Webhook. Under Execute when a check goes down, pick POST, paste your Blip URL into URL, and paste this into Request Body. You do not need any headers.

Healthchecks swaps $NAME for the check's name and $NOWfor the time. So a check called nightly-backup lands as "Cron job failed: nightly-backup".

Execute when a check goes down: Request Body
{"title": "Cron job failed: $NAME", "body": "Healthchecks marked it down at $NOW"}

Want to know when it recovers too? Fill in Execute when a check goes up the same way with this body. Or leave that part empty if you only care about failures.

Execute when a check goes up: Request Body
{"title": "Cron job is back: $NAME", "body": "Healthchecks marked it up at $NOW"}

One catch: if a check's name has a double quote in it, $NAME breaks the JSON and Blip turns the request away. Use $NAME_JSONinstead, without quotes around it. The push then shows the check name as the title and "Cron job failed" under it.

Request Body for names with quotes
{"title": $NAME_JSON, "body": "Cron job failed"}
3

Test it

Send the same JSON yourself, with a made-up check name, and watch your phone. To test the real thing, make a check in Healthchecks with a short period and grace time, ping it once, then let it go late.

terminal
curl -s -X POST https://blipnotify.com/api/v1/hooks/generic/blip_live_xxx \
  -d '{"title": "Cron job failed: nightly-backup", "body": "Healthchecks marked it down at 2026-11-09T03:15:00+00:00"}'

200 { "ok": true, "delivered": 1, "devices": 1 } · pushed to your iPhone

Want the push marked urgent?

The webhook URL above sends a normal push. It cannot mark it urgent. If a dead backup should not sit quietly in a notification summary, point Healthchecks at the Blip API instead and add "priority": "high". That makes the push time-sensitive. The API needs your key in a header, and Healthchecks lets you set headers, so this works too.

Use https://blipnotify.com/api/v1/notify as the URL, keep POST, and put these two lines in Request Headers:

Request Headers
Authorization: Bearer blip_live_xxx
Content-Type: application/json
Request Body
{"title": "Cron job failed: $NAME", "body": "Healthchecks marked it down at $NOW", "priority": "high"}

Good to know

  • Healthchecks alerts when a ping is late by more than the grace time. Your job can also report a failure right away by pinging the check's URL with /fail on the end.
  • Healthchecks tries a call 2 more times if it fails or gets no answer in 30 seconds. Blip answers with a 200, which Healthchecks counts as a success, so you get one push per down check, not three.
  • Titles are cut at 200 characters on the webhook URL. The API route turns longer titles away, so keep check names short there.
  • Each channel takes up to 60 pushes a minute. Plenty, unless every job fails at once.
  • No Healthchecks.io? The cron job guide adds one line after the job instead.

That's the whole setup.

Blip is free to try for 14 days, every feature included. After that it is $29.99/yr or $9/mo: see pricing.

Download on the App Store

More guides