Sign in Home API docs Agent Screen Sharing Privacy Support
Get Shellward
iPhone app Android app macOS agent (.dmg) Linux Windows GitHub

Home / Docs / Grafana

Grafana alerts as iPhone push notifications

Grafana's unified alerting can call a webhook whenever an alert fires or resolves. Point that webhook at Shellward and the alert lands on your iPhone in seconds, with the alert's severity mapped to push priority. No plugin, no relay, no extra service to run.

The webhook URL

Everything runs through one endpoint. Swap in your token:

https://api.shellward.app/api/ingest/grafana/YOUR_TOKEN

Step by step

What the push looks like

Shellward maps Grafana's payload to a readable notification:

Where to get your token: create an API token in the Shellward app, or at shellward.app/account, and swap it into the URL above. Full API reference in the docs.

Frequently asked

Do I need a Grafana plugin?

No. Grafana's built-in Webhook contact point is all you need. Shellward reads Grafana's standard alert payload, so there is nothing extra to install.

Does it send resolved notifications too?

Yes. When Grafana sends a resolved alert, Shellward delivers it at low priority so it stays quiet but you still see the all-clear.

Can I control the push priority?

The severity label drives it: a critical severity maps to high priority, anything else to normal, and resolved alerts to low. The alert name becomes the title and the summary annotation becomes the message.

Where do I get my token?

Create an API token in the Shellward app or at shellward.app/account, then drop it into the webhook URL in place of YOUR_TOKEN.

More recipes: GitHub Actions, cron jobs, Python, Alertmanager, Uptime Kuma, API reference