How to send push notifications with JavaScript

Updated on April 05, 2026

Learn how to send Signalgrid push notifications with plain JavaScript and the Fetch API.

Get started with Signalgrid Explore the Push API

Signalgrid makes it straightforward to send notifications from JavaScript. 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.

JavaScript works well for internal tools, dashboards, and web applications where you want to send notifications after a user action or background event.

What you need

A Signalgrid account
Your client key
A channel token
JavaScript available in your environment

Basic example

The following example sends a simple notification with JavaScript.

const payload = new URLSearchParams({
  client_key: process.env.SIGNALGRID_CLIENT_KEY,
  channel: process.env.SIGNALGRID_CHANNEL,
  title: "Deployment Finished",
  body: "The production deployment completed successfully",
  type: "SUCCESS"
});

const response = await fetch("https://api.signalgrid.co/v1/push", {
  method: "POST",
  body: payload
});

const result = await response.json();
console.log(result);

Required fields

Field

Description

client_key

Authenticates the request on behalf of your Signalgrid user

channel

The channel token that should receive the notification

title

Short notification title

body

Main notification message

type

Visual notification type such as INFO, WARN, SUCCESS, or CRIT

critical

Optional 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_token

Example: Frontend and Internal Tools