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

Bash
# Install Shoutrrr 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

Shoutrrr supports the following Signalgrid URL formats:

  • 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.

Bash
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

Bash
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