Python client library for the REST API
Clone or download
Patrick R. Schmid Patrick R. Schmid
Patrick R. Schmid and Patrick R. Schmid Update: Upcoming webinars
Latest commit d569f07 Jun 2, 2017


Python wrapper around the REST API.

This work is heavily inspired by the Ruby GEM of the same name, Zoomus


The easy way

pip install zoomus

The developer way

git clone
cd zoomus
python install


Zoomus has been tested for Python 2.6, 3.2, 3.3, 3.4, and pypy using Travis CI

Example Usage

Create the client

from zoomus import ZoomClient

client = ZoomClient('API_KEY', 'API_SECRET')

for user in json.loads(client.user.list())['users']:
    user_id = user['id']
    print client.meeting.list('host_id': user_id)

Using with a manage context

with ZoomClient('API_KEY', 'API_SECRET') as client:
    users = client.users.list()

Available methods

  • client.user.create(...)

  • client.user.cust_create(...)

  • client.user.update(...)*

  • client.user.list(...)

  • client.user.pending(...)

  • client.user.get(...)

  • client.user.get_by_email(...)

  • client.meeting.get(...)

  • client.meeting.end(...)

  • client.meeting.create(...)

  • client.meeting.delete(...)

  • client.meeting.list(...)

  • client.meeting.update(...)



  • client.webinar.create(...)

  • client.webinar.update(...)

  • client.webinar.delete(...)

  • client.webinar.list(...)

  • client.webinar.get(...)

  • client.webinar.end(...)

  • client.webinar.register(...)

Running the Tests


First, make sure to install the testing requirements

pip install -r requirements-tests.txt

Then run the tests via nose


Running the tests across multiple python versions in parallel

If you don't trust our Travis CI badge above, you can run all of the tests across multiple python versions by using pyenv and detox. A good writeup for what you need to do to set this up can be found here.

Note: If you are using OS X and installed pyenv with brew, make sure to follow these instructions as well.

You'll want to make sure that you have all of the different python versions are installed so that they can be tested:

# Install the versions
pyenv install 2.7.10
pyenv install 3.3.6
pyenv install 3.4.3
pyenv install 3.5.0

# Set all these to be global versions
pyenv global system 2.7.10 3.3.6 3.4.3 3.5.0

# Make sure that they are all there (they should all have a * next to them)
pyenv versions

Once you get everything installed, you can run the tests across the different versions as follows.


Note this assumes that you have detox installed globally.

Assuming all goes well, you should see a result akin to

py27-1.7: commands succeeded
py27-1.8: commands succeeded
py27-1.9: commands succeeded
py27-master: commands succeeded
py33-1.7: commands succeeded
py33-1.8: commands succeeded
py34-1.7: commands succeeded
py34-1.8: commands succeeded
py34-1.9: commands succeeded
py34-master: commands succeeded
py35-1.8: commands succeeded
py35-1.9: commands succeeded
py35-master: commands succeeded
congratulations :)

If you run in to an issue with running detox, make sure that you have the latest version of pip as there are some issues with pyenv and older versions of pip.


If you would like to contribute to this project, you will need to use git flow. This way, any and all changes happen on the development branch and not on the master branch. As such, after you have git-flow-ified your zoomus git repo, create a pull request for your branch, and we'll take it from there.