Grafana Phone Alerts: Send Grafana Alerts to a Phone

Send Grafana alerts to a phone

Grafana can send alert notifications through webhooks.

WakeUp Dev accepts an HTTP webhook and turns the incoming alert into a phone call to the configured on-call responder.

Basic architecture

1. Grafana Alert Rule→
2. Grafana Contact Point / Webhook→
3. WakeUp Dev→
4. Phone call→
5. Human ACK→
6. On-call cascade

How the Grafana integration works

1. Create or use a Grafana alert rule

   Grafana detects the condition you care about.

2. Configure an HTTP webhook

   Configure Grafana to send the alert to the WakeUp Dev webhook endpoint.

3. Send the alert

   Grafana sends the HTTP request when the alert fires.

4. WakeUp Dev places the call

   WakeUp Dev calls the configured on-call responder.

5. Press 1 to acknowledge

   The responder presses 1 to ACK.

6. Escalate if nobody acknowledges

   If nobody answers or acknowledges, the configured on-call cascade continues.

Grafana webhook configuration

Use Grafana’s HTTP webhook contact point to POST into WakeUp Dev. The steps below match the live WakeUp Dev alert API—no invented headers or payload schema.

1. In Grafana, create or edit an HTTP webhook contact point.
2. Set the webhook URL to https://api.wakeupdev.com/v1/alert.
3. Set the HTTP method to POST (WakeUp Dev only accepts POST).
4. Add a custom HTTP header named x-api-key with your WakeUp Dev API key from the dashboard.
5. Save the contact point.
6. Attach the contact point to the notification policy or alert rule that should wake someone.
7. Trigger a test alert and confirm a phone call arrives; press 1 to ACK.

What WakeUp Dev expects

• Endpoint: POST https://api.wakeupdev.com/v1/alert
• Required header: x-api-key: YOUR_API_KEY
• Request body: raw alert text or JSON (WakeUp Dev reads the raw body, up to 4000 bytes)
• No proprietary Grafana plugin—integration is HTTP webhook only
• On success, the API returns HTTP 202 with accepted: true and starts the on-call cascade

Example Grafana webhook

WakeUp Dev does not require a Grafana-specific JSON schema. Send plain text or JSON as the request body. Grafana’s webhook payload can be forwarded as-is, or you can send a short summary body for clearer voice synthesis.

HTTP request example

curl -X POST https://api.wakeupdev.com/v1/alert \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Grafana: production API high error rate"}'

Authentication is always via the x-api-key header. The body is treated as the alert text WakeUp Dev will summarize for the phone call.

Example JSON body

{
  "message": "Grafana: production API high error rate"
}

A successful acceptance returns HTTP 202 with accepted: true. One alert credit is consumed when the alert is accepted.

Why send Grafana alerts to a phone?

• Critical Grafana conditions can fire when the on-call responder is away from Slack or email.
• Push and chat notifications are easy to miss overnight or in Do Not Disturb.
• A phone call asks for attention in a different way than another dashboard notification.
• Press-1 ACK confirms a human saw the alert—not only that Grafana delivered a webhook.

What happens after Grafana fires

When WakeUp Dev accepts the webhook, it starts the on-call cascade and calls the first configured target.

During the call, the responder hears a voice summary of the alert body and is prompted to press 1 to acknowledge.

If the call is unanswered, fails, or ends without ACK, WakeUp Dev moves to the next number in the cascade until someone acknowledges or the cascade is exhausted.

Grafana phone alerts FAQ