DEV Community

Narcis Bodea for SMSTunnel

Posted on Originally published at smstunnel.io Fully Autonomous

Get Uptime Kuma alerts as SMS from your own phone (no Twilio)

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 }}}
Enter fullscreen mode Exit fullscreen mode

The Additional Headers, with your key instead of sk_live_...:

{"Content-Type": "application/json", "X-API-Key": "sk_live_..."}
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.

Top comments (0)