Uptime Kuma SMS notifications – integration manual

Here we describe how to send Uptime Kuma SMS notifications and alerts using SMSEagle Hardware SMS Gateway. Setup is easy and should take about 5min to complete.

SMSEagle is an offline hardware SMS gateway. Therefore no external connection to 3rd party system is required. All notifications are generated on-premise and sent directly to a cellular network. This solution can be used in secure installations without Internet access.


SMSEagle Setup

  • Create a new user in SMSEagle (menu Users > + Add Users, user access level: “User”).
  • Grant API access to the created user:
    • click Access to API beside the newly created user
    • Enable APIv1
    • Generate new token (copy it for later use)
    • Add access permissions in section APIv1 Permission for: send_sms, send_tocontact, send_togroup
    • Save settings


Uptime Kuma Setup



docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:1



  1. Go to Uptime Kuma local server URL
  2. Choose or add new Monitor
  3. Choose “Setup Notification”
  4. Notification Type > SMSEagle
  • enter parameter URL of SMSEagle: URL to your SMSEagle device (for example: https://mysmsdevice.example.com or
  • enter Access Token: SMSEagle API access token created in point above
  • enter Recipient Phone Number: recipient telephone number (or numbers separated with comma)
  • alternatively, you may enter Group Name: group name defined in SMSEagle Phonebook (remember to set the group as Public in SMSEagle)
  • Press button Create to save the configuration

Have Questions?

SMSEagle devices are designed for easy setup. If you don't have a device yet, just buy your SMSEagle and get started with your integration. If you need technical assistance or have questions about our products, we’ll be happy to help you.