How to send push notifications with Flask

Updated on March 29, 2026

Learn how to send Signalgrid push notifications
from Flask applications and Python services.

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

Flask is useful for small services, internal tools, and scripts that need a straightforward way to trigger notifications from Python.

What you need

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

Basic example

The following example sends a simple notification with Flask.

import os
import requests
from flask import Flask, jsonify

app = Flask(__name__)

@app.post("/notify")
def notify():
    response = requests.post(
        "https://api.signalgrid.co/v1/push",
        data={
            "client_key": os.getenv("SIGNALGRID_CLIENT_KEY"),
            "channel": os.getenv("SIGNALGRID_CHANNEL"),
            "title": "Flask Event",
            "body": "A Flask route triggered a notification.",
            "type": "INFO",
        },
    )

    return jsonify(response.json())

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.

export SIGNALGRID_CLIENT_KEY=your_client_key
export SIGNALGRID_CHANNEL=your_channel_token

Example: Lightweight Python Services

Flask is useful for small services, internal tools, and scripts that need a straightforward way to trigger notifications from Python.

Related Documentation