Skip to main content

Python wrapper for TeamUp Calendar's API

Project description


Python API wrapper for TeamUp API. In early stages, only has event and calendar objects implemented.

version: 0.1.1a


  • Pythonic access to TeamUp calendars and events.
  • Simple interface for gathering subcalendars and event containers.
  • Simple interface for creating and deleting events with Calendar object
  • Event Object features simple interface for updating event properties
  • Batch mode for reducing api calls for updating multiple event properties
  • If pandas is present, Calendar can return events as Series objects and event collections as DataFrame objects

Example usage

from pyteamup import Calendar, Event
from datetime import datetime

api_key = 'example api key'           # Get your own here:
calendar_id = 'example calendar id'   # goto to sign up and get your own calendar

# Instantiate the calendar
calendar = Calendar(calendar_id, api_key)

# Get Subcalendars
subcalendars = calendar.subcalendars
subcal = subcalendars[0]

# Easily Create new events
new_event_dict = {'title': 'New Event Title',
                  'start_dt': datetime(2018,11,29, 14, 0, 0),
                  'end_dt': datetime(2018, 11, 29, 14, 0, 0),
                  'subcalendar_ids': subcal['id'],
                  'notes': 'This is the description!'}
new_event = Calendar.new_event(**new_event_dict, returnas='event')

# Gather Event Collections (returns a list)
event_list = Calendar.get_event_collection()
evnt = event_list.pop()

# Simple change of the title
evnt.title = 'New Title'

# Batch Mode Updates
evnt.title = 'New Title 2'           # Will display a warning that no changes are made until batch_commit() is called
print(evnt.title)                    # Will still print the old title
evnt.notes = 'New Notes!'            # Will display a warning that no changes are made until batch_commit() is called


# Prevented from Editing Read-Only Attributes
evnt.event_id = 123                  # Will raise an error because attribute is read-only

# Easy Delete and confirm
print(evnt.is_deleted)                         # Will return True


  • Add support for updating recurring events
  • Build Subcalendar object with update support similar to Event object
  • Add Tests
  • Add more Event endpoints (get history, get auxilliary info)
  • Add More Calendar endpoints (searching for events)
  • Add Access Key Endpoints
  • Add Color Swatch Lookup (create simple assignments for red, blue, green, etc)
  • Add support for password protected calendars
  • Add support for beta features: undo, custom fields, comments, signup


Using pip Current Version: 0.1.0a1):

python -m pip install pyTeamUp

Batch Mode

Events objects feature a batch mode for setting multiple values with a single api call, reducing your api usage and reducing the liklihood of TeamUp disabling your api key! Simply call event.enable_batch_mode() and begin making changes. When satisfied changes can be commited by calling event.batch_commit() which will automatically exit batch mode after, or call event.disable_batch_mode(clear=True) to discard changes.

Setting event data without enabling batch mode will cause each change to use an api request.


Use issue tracker please :)



Change Log


  • Fixed versioning
  • Fixed file names, fixed import bug


  • Added "get_changed_events" method to Calendar (credit: vranki)


  • Initial realease

Project details

Download files

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

Files for pyTeamUp, version 0.1.1a0
Filename, size File type Python version Upload date Hashes
Filename, size pyTeamUp-0.1.1a0-py3-none-any.whl (19.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pyTeamUp-0.1.1a0.tar.gz (17.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page