Signalgrid Push Api

curl -s \
    --form-string "client_key=[client-key]" \
    --form-string "channel=[channel-token]" \
    --form-string "type=INFO" \
    --form-string "title=This is the title" \
    --form-string "body=This is the body." \
https://api.signalgrid.co/v1/push
                                

API Endpoint

Notifications are sent using the following endpoint:

POST https://api.signalgrid.co/v1/push

Basic Example

The following example sends a simple push notification using curl.

curl -X POST https://api.signalgrid.co/v1/push \
    -d "client_key=YOUR_CLIENT_KEY" \
    -d "channel=CHANNEL_TOKEN" \
    -d "title=Deployment Finished" \
    -d "body=The production deployment completed successfully"

After the request is sent, the notification will appear instantly on all devices subscribed to the specified channel.

Response

If the request was processed successfully, the API returns a response similar to the following:

{
    "ruuid":"3c9c92a7d8e641a1bfa3c0b2a2c8b1d4f45e3c22",
    "text":"OK",
    "code":"200",
    "node":"dp01",
    "time":"284ms",
    "remaining":"9813"
}

The response contains metadata about the processed request and the node that handled it.

Notification Parameters

Critical Notifications

Critical notifications are intended for important alerts such as infrastructure failures or monitoring incidents.

When critical=true is used:

• iOS delivers the notification using Critical Alerts
• Android bypasses Do Not Disturb

curl -X POST https://api.signalgrid.co/v1/push \
    -d "client_key=YOUR_CLIENT_KEY" \
    -d "channel=CHANNEL_TOKEN" \
    -d "title=Server Down" \
    -d "body=The web server is not responding" \
    -d "critical=true" \
    -d "type=CRIT"

Programming Language Integrations

Any environment capable of making HTTP requests can send Signalgrid notifications, making it easy to integrate into monitoring systems, CI/CD pipelines, backend services, and automation workflows.
To simplify integrations even further, we have developed a variety of ready-to-use libraries and plugins.