---
id: notifications-python-client
version: "12.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# notifications-python-client — Python API client for GOV.UK Notify.

License: permissive · Maintenance: active · Downloads: 209.8K/mo

## What it is and what it does

This is an official Python client for GOV.UK Notify, a UK government service that handles transactional communications. It wraps the Notify API to let you send emails, SMS text messages, and physical letters from Python code without managing SMTP servers or carrier integrations yourself. The client handles authentication via PyJWT, makes HTTP requests through requests, and provides a command-line interface via docopt.

The package is maintained by the UK government's digital service (alphagov) and is actively developed. It targets modern Python versions (3.9 through 3.14) and is classified as Beta maturity. Use it when your application needs to send notifications through an official government channel or when you're building services that integrate with GOV.UK infrastructure.

Use it for:

- Send confirmation emails and SMS alerts from a UK government service or citizen-facing application.
- Notify users of application events (password resets, appointment reminders, status updates) via email or text.
- Dispatch physical letters for formal communications or official correspondence.
- Integrate transactional notifications into a larger government digital service without managing mail infrastructure.
- Batch-send notifications to multiple recipients using the Notify API from a Python backend.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for sending emails, text messages, and letters through the GOV.UK Notify API.

Yes, if you are building a service that uses GOV.UK Notify. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It is the official client and integrates cleanly with standard Python tooling. Not relevant outside the GOV.UK Notify ecosystem.

## Install

pip install notifications-python-client
uv add notifications-python-client
poetry add notifications-python-client

## Installing notifications-python-client

Before you install: Low install friction with a pure-Python wheel distribution. The package is actively maintained with a recent release and depends on three stable, widely-used libraries: requests, PyJWT, and docopt.

License in practice: MIT license is permissive and places no significant restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

pip install notifications-python-client

from notifications_python_client.notifications import NotificationsAPIClient

client = NotificationsAPIClient(api_key='your-api-key')
response = client.send_email_notification(email_address='user@example.com', template_id='template-id')

Requires a GOV.UK Notify account and API key to send notifications; the service is specific to UK government use.

Verify before relying:

- Whether the package supports rate limiting or retry logic for production workloads.
- Whether async/await patterns are supported for concurrent notification sending.
- Specific rate limits or quotas imposed by the GOV.UK Notify service itself.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 209.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gov.uk notify python client, send emails via govuk notify, bulk sms and email api, government notification service, python email sms letters api, govuk notify integration, transactional email client, gov-uk, notifications, transactional-email

[View on SkillFed](https://skillfed.io/packages/notifications-python-client) · [View on PyPI](https://pypi.org/project/notifications-python-client/)