Uptime Kuma tells you when a site or a service goes down. Here's how to get that alert as a real SMS on your own number, sent by an Android phone you own: no SMS provider in between, no per-message fee, and no plugin, because Uptime Kuma's built-in Webhook notification does it.
What you need
- An Android phone with a SIM card. It sends the texts.
- The free SMSTunnel app on that phone, signed in to your SMSTunnel account.
- Uptime Kuma.
The quick way: a webhook address, no key
A webhook address is a secret URL that turns each call into a text to the numbers saved with it. The call only sets the words, never the number, so Uptime Kuma needs no key.
- In the SMSTunnel dashboard, open Apps → Webhooks, click New webhook and pick Uptime Kuma.
- Add the numbers that should get the texts, with
+and the country code (up to 10; each gets its own text), then click Create the webhook. - Copy the address,
https://smstunnel.io/api/v1/webhook/<token>. Keep it secret, like a password.
In Uptime Kuma, open Settings → Notifications → Set Up Notification:
| Field | Value |
|---|---|
| Notification Type | Webhook |
| Post URL | your webhook address |
| Request Body | Preset - application/json |
| Additional Headers | off: the address is the secret |
A webhook answers 20 calls an hour unless you raise it (up to 500), so a storm of alerts can't use up your texts. Its texts are cut at 480 characters.
Full control: an API key
In the dashboard, open Apps → Add an app, pick Uptime Kuma and click Create the key (it's shown only once). Then set up the notification like this:
| Field | Value |
|---|---|
| Notification Type | Webhook |
| Post URL | https://smstunnel.io/api/v1/sms/send |
| HTTP Method | POST (newer versions show this field) |
| Request Body | Custom Body |
| Additional Headers | on |
The Custom Body, with your number in international format:
{"to": "+14155550123", "message": {{ msg | json }}} The Additional Headers, with your key instead of sk_live_...:
{"Content-Type": "application/json", "X-API-Key": "sk_live_..."} Keep {{ msg | json }} as it is: it puts Uptime Kuma's alert in the text, with the quotes JSON needs. One notification texts one number, so add one per person, or use a webhook address.
Test it, then attach it
Test texts <Friendly Name> Testing right away. With a wrong key, Uptime Kuma shows a 401 and "Invalid or expired API key". Then click Save and tick the notification on your monitors: Default enabled adds it to new monitors, Apply on all existing monitors to the ones you have.
The texts look like this:
[My shop] [🔴 Down] timeout of 48000ms exceeded [My shop] [✅ Up] 200 - OK Good to know
- With a key, texts can be up to 1600 characters, and a 429 means more than 30 texts a minute.
- Phone offline? The text waits and goes out when the phone is back.
- The free plan has 25 texts a day, plenty for down alerts.
Full guide: https://smstunnel.io/integrations/uptime-kuma/
Disclosure: I build SMSTunnel. This post was written with AI from the official setup guide linked above.

