Urban Airship

Airship Python Library

urbanairship is a Python library for using the Airship web service in support of our messaging product lines and related features.


Using pip:

$ pip install urbanairship

Using the library

The library is intended to be used with the small footprint of a single import. To get started, import the package, and create an Airship object representing a single UA application.

Note that channels are preferred over device_token and apid. See: documentation on channels.

import urbanairship as ua
airship = ua.Airship('<app key>', '<master secret>')

push = airship.create_push()
push.audience = ua.ios_channel('074e84a2-9ed9-4eee-9ca4-cc597bfdbef3')
push.notification = ua.notification(ios=ua.ios(alert='Hello from Python', badge=1))
push.device_types = ua.device_types('ios')

The library uses requests for communication with the Airship API, providing connection pooling and strict SSL checking. The Airship object is threadsafe, and can be instantiated once and reused in multiple threads.


When creating an instance of urbanairship.Airship, an optional argument may be added to specify use of Airship’s EU data center. If no location argument is passed, the US data center will be used.

import urbanairship as ua
eu_airship = ua.Airship('<app_key>', '<master_secret>', location='eu')


urbanairship uses the standard logging module for integration into an application’s existing logging. If you do not have logging configured otherwise, your application can set it up like so:

import logging

If you’re having trouble with the Airship API, you can turn on verbose debug logging.


As of Python 2.7, DeprecationWarning warnings are silenced by default. To enable them, use the warnings module:

import warnings


The library source code is available on GitHub.

Tests can be run with nose:

nosetests --with-doctest


Indices and tables

Apple, StoreKit and iPhone are trademarks of Apple, Inc. Maponics Neighborhood Boundaries © Maponics 2012. DMA® is a registered service mark of The Nielsen Company. Used under License.