---
id: novu
version: "1.14.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# novu — This project aims to provide a wrapper for the Novu API.

License: permissive · Maintenance: dormant · Downloads: 88.3K/mo

## What it is and what it does

Novu is a Python wrapper around Novu's notification management API. It provides classes like EventApi, SubscriberApi, TopicApi, FeedApi, EnvironmentApi, and TenantApi to programmatically manage notifications, subscribers, and notification workflows. The package depends only on requests for HTTP communication.

You use it by instantiating an API class with your Novu URL and API key, then calling methods to trigger notification events, create or list subscribers, manage topics for bulk notifications, or administer feeds and environments. The SDK supports single event triggers, bulk event triggers, and broadcast notifications to all subscribers.

Use it for:

- Trigger notification events from your application to subscribers based on workflow identifiers defined in Novu.
- Bulk-trigger multiple notification events at once using InputEventDto objects.
- Manage subscriber data (create, retrieve, list) programmatically within your application.
- Subscribe or unsubscribe groups of subscribers to topics for targeted bulk notifications.
- Administer notification feeds and environments as part of a larger notification infrastructure.

## Worth the install?

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

Python SDK for Novu's notification API, providing a fluent interface to trigger events, manage subscribers, topics, feeds, and environments.

Yes, if you are actively using Novu and need a Python client to integrate notifications into your application. The low install friction and permissive license make it straightforward to add. However, the dormant maintenance status (last release 900 days ago) means you should verify compatibility with your current Novu API version and be prepared to fork or patch if breaking changes occur on Novu's side.

## Install

pip install novu
uv add novu
poetry add novu

## Installing novu

Before you install: Low install friction with a single runtime dependency (requests). Maintenance is dormant—last release was 900 days ago—so expect no active bug fixes or feature updates.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install novu

from novu.api import EventApi

event_api = EventApi("https://api.novu.co", "<NOVU_API_KEY>")
event_api.trigger(
    name="<YOUR_WORKFLOW_ID>",
    recipients="<YOUR_SUBSCRIBER_ID>",
    payload={},
)

Requires a Novu account with an API key from https://web.novu.co/settings and a pre-created notification workflow.

Verify before relying:

- Whether the dormant maintenance status affects compatibility with current Novu API versions.
- Whether requests library version constraints exist beyond what the fact sheet specifies.

## Package facts

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

## Tags

notification api client, novu sdk python, event triggering notifications, subscriber management api, notification workflow integration, novu api wrapper, bulk event triggering, notification-api, dormant-maintenance

[View on SkillFed](https://skillfed.io/packages/novu) · [View on PyPI](https://pypi.org/project/novu/)