Skip to main content

Python wrapper for Drip's REST API

Project description

drip-python Coverage Status CircleCI

Python wrapper for the Drip REST API at


pip install drip-python


Initialize the client

>>> from drip import Client
>>> d = Client(API_TOKEN, ACCOUNT_ID)

Use the client's methods

>>> d.fetch_user()
{'email': '', 'name': 'Ross Hodapp', 'time_zone': 'America/Chicago'}

Main Concepts

Be sure to check out the Wiki!

1. Additional Options

Beyond the required arguments, any additional keyword arguments will be added to the call as well. Check the docs for what's available.

>>> cfs = {'first_name': 'Ross'}
>>> d.create_or_update_subscriber('', custom_fields=cfs)
{'email': '', 'custom_fields': {'first_name': 'Ross'}, ... }

2. Unpacking the response

The Drip REST API often returns extra data along side the results you're asking for.

The Client takes care of unpacking that data for you, returning lists, dictionaries, or strings as necessary. If the response doesn't have a body, result will return True or False if the call was successful or not.

If you'd like the raw response, pass the keyward argument marshall=False to the method call.

>>> d.fetch_user(marshall=False)
<Response [200]>

3. Pagination

Most calls that return a list are paginated. By default, the Client automatically gets the maximum amount of objects per page and automatically gets all available pages.

Use the page and per_page keyword arguments. If a valid page is passed to the function, then this will fetch that page only (or the single Response if not marshalled per above).

Otherwise-- that is, if page is 0 (default) or negative-- then this will fetch the entire collection and return the full list. This will ignore the per_page keyword argument and use 1000 for maximum efficiency.

Currently, I won't support getting all pages of 1 object per page for example, since I don't see a valid use-case for this.

This means essentially that per_page only makes sense when asking for a specific 'page'. This also means that you can only marshall a specific page (this may change in the future).

Anyway, the default case will be what you want most of the time, so don't worry about this too much.

>>> all_subscribers = d.subscribers()
>>> len(all_subscribers)

>>> first_page = d.subscribers(page=1)
>>> len(first_page)

>>> last_page = d.subscribers(page=13)
>>> len(last_page)

>>> big_first_page = d.subscribers(page=1, per_page=1000)
>>> len(big_first_page)

>>> big_last_page = d.subscribers(page=2, per_page=1000)
>>> len(big_last_page)

>>> marshall_without_page = d.subscribers(marshall=False)
>>> len(marshall_without_a_page)

>>> marshall_with_page = d.subscribers(page=1, marshall=False)
>>> marshall_with_page
<Response [200]>


Status - v0.3.0 Beta

While devotedly and enthusiastically maintained, this is an un-official side-project and Drip Support is unable to fix issues you run into. Create an Issue on GitHub here instead. Thanks!


  • Full API coverage, including "v3" Shopper Activity and future endpoints
  • Full unittest code coverage
  • Every endpoint tested live
  • Documentation (readthedocs? github wiki?) wiki!
  • Web framework support, namely Django and Responder
  • NoSQL utilities
  • AsyncIO support Basically needs a differend repo?



  • Repostiry updates


  • Added raising Errors for when the HTTP call is successful but the API returned that there were errors


  • Added Product support for the Shopper Activity API! Check that out here: Product Activity

Project details

Download files

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

Source Distribution

drip-python-0.3.1.tar.gz (14.8 kB view hashes)

Uploaded source

Built Distribution

drip_python-0.3.1-py3-none-any.whl (20.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page