Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Unofficial API wrapper

Project Description


Python wrapper for the API.

Send push notifications to mobile devices without writing your own mobile app. Have notifications pushed to you rather than relying on polling RSS feeds and the like.


Currently only the push functionality and some of the OAuth2 is implemented here.

Basic usage:

import pushed


p = pushed.Pushed(APP_KEY, APP_SECRET)

# Push message to your application's subscribers
shipment = p.push_app('test app push')

# Push message to your channel's subscribers
shipment = p.push_channel('test channel push', CHANNEL_ALIAS)

# Push message to a user by Pushed ID
shipment = p.push_pushed_id('test Pushed ID push', PUSHED_ID)

# Push URL enriched message to your application's subscribers
shipment =  p.push_app('test app push', content_url='')

Pushing to a user requires an OAuth2 access token. You must swap a temporary code for this access token using the Pushed API. These temporary codes arrive by webhook, when a subscriber follows your authorization link and agrees to the access.

To generate an authorization link to share with your users:

p = pushed.Pushed(APP_KEY, APP_SECRET)
uri = p.authorization_link('')

Using a code to get an access token, then sending a message to the user:

p = pushed.Pushed(APP_KEY, APP_SECRET)
access_token = p.access_token(temporary_code)
shipment = p.push_user('test user push', access_token)

All four push methods return an alphanumeric Shipment ID which you can check against your control panel. If the Pushed API returns a JSON failure message then a PushedAPIError will be raised using its type and message fields.

The content_url parameter is optional and is supported by all push types. It allows you to enrich your messages with a hyperlink if desired.


Using pip

pip install pushed
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pushed-0.1.4-py2.py3-none-any.whl (5.7 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Mar 15, 2016
pushed-0.1.4.tar.gz (3.7 kB) Copy SHA256 Checksum SHA256 Source Mar 15, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting