Grafana Push Notifications

Updated on November 20, 2026 Grafana Repository Grafana Alerting

Send Grafana firing and recovery alerts to iPhone, Android, and the web
with a custom Webhook contact point and Signalgrid.

Receive Grafana alert notifications on mobile

Send Grafana firing and resolved alerts to your iPhone, Android device, or browser through Signalgrid. A webhook contact point formats the alert group into a Signalgrid request, so your existing Grafana notification policies can deliver mobile alerts.

Prerequisites

  • Grafana Alerting with a Webhook contact point that exposes Custom Payload, Payload Template and Payload Variables.
  • An alert rule with a useful summary annotation.
  • A Signalgrid account with an iPhone, Android device, or web client registered to receive notifications.
  • Your Signalgrid client key and a channel token. Use the channel token rather than the channel name.
  • Outbound HTTPS access to https://api.signalgrid.co.

Custom Payload availability

This setup requires the Custom Payload option. Its availability depends on your Grafana version and deployment; Grafana documents that it is not generally available in Grafana Cloud. Check that the option exists before configuring this integration.

Create the notification template

Open Grafana Alerting notification configuration and create a notification template group. Name the group Signalgrid and paste this template:

Go
{{ define "signalgrid.form" -}} {{- $title := printf "Grafana %s: %s" .Status .CommonLabels.alertname -}} {{- $message := printf "%s\n%s" .CommonAnnotations.summary .ExternalURL -}} {{- $type := "WARN" -}} {{- if eq .Status "resolved" }}{{ $type = "SUCCESS" }}{{ end -}} client_key={{ urlquery .Vars.client_key }}&channel={{ urlquery .Vars.channel }}&title={{ urlquery $title }}&body={{ urlquery $message }}&type={{ $type }}&critical=false {{- end }}

The template URL-encodes the credentials, title and message, then produces form data for Signalgrid. It sends one notification per Grafana notification group. Add a summary annotation to your alert rules so the body describes the incident; group related alerts in your notification policy as appropriate.

Configure the Webhook contact point

  • Open Alerts & IRM → Alerting → Notification configuration → Contact points. Menu names can differ between versions.
  • Add a contact point named Signalgrid and select the Webhook integration.
  • Set the URL and method below, then configure the Extra Headers and Custom Payload fields.
Setting
Value
URL
https://api.signalgrid.co/v1/push
HTTP Method
POST
Extra Headers
Content-Type: application/x-www-form-urlencoded
Payload Template
{{ template "signalgrid.form" . }}
Payload Variables: client_key
YOUR_CLIENT_KEY
Payload Variables: channel
YOUR_CHANNEL_TOKEN

Replace the two variable values with your credentials and save. Use Extra Headers to override Grafana's default JSON content type. The custom template generates the entire request body, so leave the ordinary Title and Message settings at their defaults. Restrict contact-point editing to administrators who may access these credentials.

Test firing and resolved alerts

  • Use Test on the contact point and send a test notification. Confirm it appears in Signalgrid.
  • Assign the contact point to an alert rule or route it through a notification policy.
  • Trigger a controlled test alert and check the title, summary and destination channel.
  • Resolve the alert and confirm the recovery arrives. Keep Disable resolved message off if you want recovery notifications.

Choose the alert details

The example uses .CommonLabels.alertname in the title and .CommonAnnotations.summary in the body. These common fields can be empty when the group contains alerts with different values. Adjust the grouping or template to include the labels and annotations important to your team.

Send critical alerts

For urgent incidents, set critical to true and type to CRIT. These are separate settings: the visual notification type alone does not enable critical delivery. Critical notifications require a Single or Teams subscription and the appropriate device permissions. See Critical Notifications for iOS Critical Alerts and Android notification settings. Keep routine results non-critical.

To enable critical delivery with this template, change the literal critical=false to critical=true. For firing alerts, change the initial $type := "WARN" to $type := "CRIT". Route only urgent rules to that contact point; keep a separate non-critical contact point for routine alerts and recoveries.

Troubleshooting

  • Custom Payload is missing: check feature availability in your Grafana deployment. The default Grafana JSON payload is not the form body used here.
  • Template cannot be found: save the template group and use the exact name signalgrid.form.
  • Signalgrid rejects the request: verify both Payload Variables, the overridden Content-Type and the generated form body.
  • Test works but real alerts do not: check notification policies, mute timings, rule routing and notification grouping.
  • Missing summary: set a summary annotation and check whether it is common to all alerts in the group.

Official documentation