Pingram Python SDK

Official Python SDK for Pingram. Send notifications via Email, SMS, Push, In-App, and more from your server-side Python code.

Requirements

Python 3.9+
Dependencies: httpx, pydantic, python-dateutil, typing-extensions (installed automatically)

Installation

pip install pingram-python

To install from source (e.g. from the GitHub repo):

pip install -e sdks/python

Quick start

Use the Pingram client with your API key, then call send() or the namespaced APIs (user, users, logs, etc.).

import asyncio
from pingram import Pingram, SenderPostBody, SenderPostBodyTo

async def main():
    # API key (e.g. pingram_sk_...) or JWT; optional region ("us" | "eu" | "ca")
    async with Pingram(api_key="pingram_sk_...") as client:
        # Send a notification
        body = SenderPostBody(
            notification_id="your_notification_id",
            to=SenderPostBodyTo(id="user_123"),
        )
        response = await client.send(sender_post_body=body)
        print(response)

        # Or use namespaced APIs (same as Node: client.user, client.users, client.logs, ...)
        # user = await client.user.user_get_user(account_id="...", user_id="...")
        # logs = await client.logs.logs_query_logs(...)

asyncio.run(main())

You can also pass a config dict: Pingram({"api_key": "pingram_sk_...", "region": "eu"}). For full API coverage, use client.send, client.user, client.users, client.logs, client.templates, client.environments, and the other APIs.

Metadata

Release files for pingram-python 1.0.23

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pingram-python 1.0.23
File	Size	Uploaded
pingram_python-1.0.23.tar.gz	158.1 kB	Aug 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pingram-python 1.0.23
File	Interpreter	ABI	Platform	Reset
pingram_python-1.0.23-py3-none-any.whl 510.1 kB Aug 20, 2026	Python 3	none	any	Details

Total release size: 668.2 kB

Release files / pingram_python-1.0.23.tar.gz

Download URL	pingram_python-1.0.23.tar.gz
Size	158.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`8e05a285c89c8bf949e95477afbf199881896926fe848364deda47dd4b4666df`
BLAKE2b-256 checksum How to use checksums	`b1b983075bb9cc550fce6f2b46611b8ac048eaa225522294459df0504029b8e1`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`

Release files / pingram_python-1.0.23-py3-none-any.whl

Download URL	pingram_python-1.0.23-py3-none-any.whl
Size	510.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d06817c33542aa4abc6014245d61cc5cccdac293c949fb8415758e6cd0aa88cd`
BLAKE2b-256 checksum How to use checksums	`6be858fc282ef2892ea776ca4638e714dc69126ead6b7f7627a409b0a04d68a9`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`