How to send push notifications with cURL
Updated on August 22, 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"Critical example
The following example sends a critical 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=Database Down" \
-d "body=The primary database is not responding" \
-d "type=CRIT" \
-d "critical=true"The important part is critical=true - that is what delivers the notification as critical. type=CRIT only controls the presentation in the GUI, for example showing it in red.
It's also possible to send a notification of type=INFO as critical.
For more information about how critical notifications behave on iOS, Android, and Web, see Critical Notifications.
Parameters
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