No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 12 commits ahead, 789 commits behind urbanairship:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



This here is a library for using the Urban Airship web service API for iPhone and Android C2DM push notifications.


Tested on Python 2.5 and 2.6 -- it'll probably work on earlier versions. If you're using Python 2.5 or earlier, you'll need to install simplejson.


As of 0.42 the library handles these parts of the API:

  • device token registration
  • APID token registration
  • basic push
  • registering and pushing with tags
  • broadcast
  • feedback service
  • device token deactivation (deregistration)
  • device token listing

iOS Usage

>>> import urbanairship
>>> airship = urbanairship.Airship(application_key, master_secret)
>>> airship.register('valid_token', alias='adam')
>>> airship.push({'aps': {'alert': 'Hello'}}, aliases=['adam'],
...     device_tokens=['some_other_token'])

Android C2DM Usage

>>> import urbanairship
>>> airship = urbanairship.Airship(application_key, master_secret)
>>> airship.registerAPID('valid_token', alias='matt')
>>> airship.push({'android': {'alert': 'Hello'}}, aliases=['matt'],
...     device_tokens=['some_other_token'])

Unit Tests Usage

  • copy keys-example.ini to keys.ini
  • edit keys.ini with your test master secret and application secret keys
  • run


The best place to ask questions is our developers mailing list:


  • 0.1 Initial release
  • 0.2 Added tags, broadcast, feedback
  • 0.3 Added deregister, device token list, other minor improvements
  • 0.4 Added Android C2DM APID support
  • 0.42 Merged schedule_for fork into this branch (from hkukreja)