How to send push notifications with Express.js
Updated on April 05, 2026
Learn how to send Signalgrid push notifications
Signalgrid makes it straightforward to send notifications from Express.js. 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.
Express.js works well when you want to send a notification after receiving a webhook, finishing a job, or handling an important API event.
What you need
- A Signalgrid account
- Your client key
- A channel token
- Express.js available in your environment
Basic example
The following example sends a simple notification with Express.js.
app.post("/deploy", async (req, res) => {
const payload = new URLSearchParams({
client_key: process.env.SIGNALGRID_CLIENT_KEY,
channel: process.env.SIGNALGRID_CHANNEL,
title: "Deploy Triggered",
body: "A new deployment has started.",
type: "INFO"
});
const response = await fetch("https://api.signalgrid.co/v1/push", {
method: "POST",
body: payload
});
const result = await response.json();
res.json(result);
});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.
SIGNALGRID_CLIENT_KEY=your_client_key
SIGNALGRID_CHANNEL=your_channel_tokenExample: API Routes and Webhooks
Express.js works well when you want to send a notification after receiving a webhook, finishing a job, or handling an important API event.