Send Push Notifications with Shoutrrr

Updated on August 31, 2026 Git Repository

Send Signalgrid push notifications through Shoutrrr using its native
Signalgrid URL support.

Get started with Signalgrid Explore our API

Installation

The quickest way to install Shoutrrr is with Go:

go install github.com/nicholas-fedor/shoutrrr/shoutrrr@latest

If you do not want to build it yourself, you can also download a release binary from the Shoutrrr GitHub releases page.

Signalgrid URL format

signalgrid://CLIENT_KEY@CHANNEL
signalgrid://CLIENT_KEY@CHANNEL?title=Deployment%20finished
signalgrid://CLIENT_KEY@CHANNEL?critical=Yes&type=CRIT

Parameters

Part
Description
CLIENT_KEY
Your Signalgrid client key
CHANNEL
Your Signalgrid channel token
title
Optional notification title
type
Optional Signalgrid type such as INFO, WARN, CRIT, or SUCCESS
critical
Optional urgent delivery flag

Send a notification

The message body you pass to Shoutrrr becomes the Signalgrid notification body.

shoutrrr send \
  --url 'signalgrid://YOUR_CLIENT_KEY@YOUR_CHANNEL_TOKEN?title=Deployment%20finished&type=SUCCESS' \
  'Version 2.4.0 is now live.'

Send a critical notification

shoutrrr send \
  --url 'signalgrid://YOUR_CLIENT_KEY@YOUR_CHANNEL_TOKEN?title=Server%20down&type=CRIT&critical=Yes' \
  'The primary web node is not responding.'

See also

Push API Find your Client Key Find your Channel Token
Any questions? Contact support.
LLM? Read llms.txt.
Visit us on GitHub