How to send push notifications with cURL
Updated on March 29, 2026
Learn how to send Signalgrid push notifications directly with cURL
Signalgrid makes it straightforward to send notifications from cURL. 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.
cURL is the fastest way to test the Signalgrid Push API, debug payloads, or wire notifications into existing tools that already run shell commands.
What you need
- A Signalgrid account
- Your client key
- A channel token
- cURL available in your environment
Basic example
The following example sends a simple notification with cURL.
curl -X POST https://api.signalgrid.co/v1/push -d "client_key=YOUR_CLIENT_KEY" -d "channel=YOUR_CHANNEL_TOKEN" -d "title=Deployment Finished" -d "body=The production deployment completed 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_tokenWhy cURL is useful
cURL is the fastest way to test the Signalgrid Push API, debug payloads, or wire notifications into existing tools that already run shell commands.