---
id: onesignal-python-api
version: "5.11.3"
license: unclear
license_treatment: unclear
maintenance: active
---

# onesignal-python-api — OneSignal

License: unclear · Maintenance: active · Downloads: 135.4K/mo

## What it is and what it does

This is a Python wrapper for the OneSignal messaging API, auto-generated from OpenAPI specifications. It provides a programmatic interface to OneSignal's push notification and customer engagement services, allowing you to send personalized messages, manage subscribers, and track campaign performance from Python code.

The library depends on urllib3 for HTTP requests and python-dateutil for date handling. It supports Python 3.6 and later. The package is actively maintained with no known security vulnerabilities. However, the license terms are not clearly documented in the package metadata, which is a notable gap for production use.

Use it for:

- Send bulk push notifications to mobile app users based on segmentation or user behavior.
- Automate customer engagement workflows triggered by application events.
- Manage OneSignal subscriber lists and user attributes programmatically.
- Integrate OneSignal messaging into a Python backend service or data pipeline.
- Track and retrieve campaign analytics and delivery metrics.

## Worth the install?

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

A Python client library for the OneSignal API that enables sending personalized messages and managing customer engagement through OneSignal's messaging platform.

Yes, with conditions. The package is actively maintained, has low install friction, and serves a clear purpose for OneSignal users. However, install only after verifying the license terms—the unclear license status is a real blocker for production or commercial use. If you are already committed to OneSignal and can confirm the license is acceptable, this is a straightforward choice.

## Install

pip install onesignal-python-api
uv add onesignal-python-api
poetry add onesignal-python-api

## Installing onesignal-python-api

Before you install: Low install friction with only two lightweight runtime dependencies (urllib3 and python-dateutil). Actively maintained with a recent release.

License in practice: License status is unclear; no SPDX identifier or raw license text is available. Verify the actual license terms before using in production or redistributing.

Quickstart:

pip install onesignal-python-api

import onesignal_python_api
from onesignal_python_api.client import Client

client = Client(user_key='your_key', app='your_app')

Requires Python 3.6 or later. OneSignal API credentials (user key and app ID) are needed to authenticate.

Verify before relying:

- Whether the package is officially maintained by OneSignal or a third party (generated via OpenAPI-Generator).
- What the actual license is and any redistribution or commercial use restrictions.
- Whether documentation or examples are available beyond the API reference.
- Download volume and actual user base size beyond the top-15000 popularity tier.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 135.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

onesignal python client, push notification api, customer messaging platform, onesignal sdk, bulk message sending, engagement automation, messaging-api, push-notifications

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