Sending Notifications with Python

Updated on May 16, 2026 Git Repository PyPI

Learn how to send Signalgrid notifications from Python applications using the official pip package

Get started with Signalgrid Explore our API

Signalgrid provides an official Python library that allows you to send notifications from scripts, services, and automation workflows.

The library works well with:

Python scripts
Automation tools
Monitoring systems
CI/CD pipelines
Backend services

Installation

Install the Signalgrid Python package using pip:

pip install signalgrid

This installs the Signalgrid client library and its dependencies.

Basic Usage

To send a notification, create a Signalgrid client and call send().

from signalgrid import Client

client = Client("YOUR_CLIENT_KEY")

response = client.send({
    "channel": "YOUR_CHANNEL_TOKEN",
    "title": "Server Alert",
    "body": "Database connection lost",
    "type": "CRIT",
    "critical": True
})

print(response)

Parameters

Parameter

Description

channel

Channel token that receives the notification

title

Notification title

body

Notification message

type

Notification type (INFO, WARN, CRIT, SUCCESS)

critical

Sends a critical notification

Example types:

"type": "INFO"
"type": "WARN"
"type": "CRIT"
"type": "SUCCESS"

Example: Script Notification

The following example sends a notification when a script finishes.

from signalgrid import Client

client = Client("YOUR_CLIENT_KEY")

client.send({
    "channel": "YOUR_CHANNEL_TOKEN",
    "title": "Backup Completed",
    "body": "Nightly backup finished successfully",
    "type": "SUCCESS"
})

Example: Error Alert

from signalgrid import Client

client = Client("YOUR_CLIENT_KEY")

client.send({
    "channel": "YOUR_CHANNEL_TOKEN",
    "title": "Server Down",
    "body": "The web server stopped responding",
    "type": "CRIT",
    "critical": True
})

This sends a critical alert that bypasses Do Not Disturb on supported devices.

Using Environment Variables (Recommended)

Avoid hardcoding your client key.

Instead use environment variables:

import os
from signalgrid import Client

client = Client(os.getenv("SIGNALGRID_CLIENT_KEY"))

Example environment variable:

export SIGNALGRID_CLIENT_KEY=abc123