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.

  1. In the SMSTunnel dashboard, open Apps → Webhooks, click New webhook and pick Uptime Kuma.
  2. 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.
  3. 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.