How to send push notifications with Bash
Updated on March 29, 2026
Learn how to send Signalgrid push notifications
Signalgrid makes it straightforward to send notifications from Bash. The platform uses a simple model built around your client_key, a target channel, and a few core fields such as title, body, type, and optional critical.
Bash is a solid choice for cron jobs, deployment hooks, backup scripts, and other automation tasks that need a quick success or failure notification.
What you need
- A Signalgrid account
- Your client key
- A channel token
- Bash available in your environment
Basic example
The following example sends a simple notification with Bash.
#!/usr/bin/env bash
curl -X POST https://api.signalgrid.co/v1/push -d "client_key=${SIGNALGRID_CLIENT_KEY}" -d "channel=${SIGNALGRID_CHANNEL}" -d "title=Build Complete" -d "body=The build finished successfully" -d "type=SUCCESS"Required fields
Field
Description
client_keyAuthenticates the request on behalf of your Signalgrid user
channelThe channel token that should receive the notification
titleShort notification title
bodyMain notification message
typeVisual notification type such as
INFO, WARN, SUCCESS, or CRITcriticalOptional flag for urgent notifications
Environment variables
Keeping credentials outside your code is usually the better move.
export SIGNALGRID_CLIENT_KEY=your_client_key
export SIGNALGRID_CHANNEL=your_channel_tokenExample: CI and Shell Automation
Bash is a solid choice for cron jobs, deployment hooks, backup scripts, and other automation tasks that need a quick success or failure notification.