Skip to main content

A Python wrapper for the Planning Center Online API.

Project description

Pypco ReadMe

Pypi Version Documentation Status Build codecov Pypi Python Versions Checked with mypy

Stop writing boilerplate code to communicate with the Planning Center Online REST API, and start using pypco! Pypco is a Python wrapper library that supports the full breadth of the PCO REST API. With pypco, you'll spend less time worrying about building and managing HTTP requests and more time building cool things.

>>> Read the Docs (stable) <<<


  • Boilerplate Done for You: No need to manage HTTP requests, and useful helper functions included (authentication, iteration/pagination, new object templating, etc.)!
  • Automatic rate limit handling: If you hit your rate limit, pypco will automatically pause requests and continue once your rate limit period has expired.
  • Automatic Pagination: Pypco provides automatic pagination/object iteration, allowing you to quickly and easily retrieve large numbers of objects off from the PCO API.
  • Simple Wrapper API: Using API wrappers can feel like learning two new APIs: the REST API itself and the wrapper you're using. Pypco's simple approach is built around the HTTP verbs you already know: GET, POST, PATCH, and DELETE. As a result, after a few minutes with the pypco docs you'll be spending your time in the PCO API docs instead and be on your way to getting things done.
  • Full API Support: Pypco supports all versions of the PCO v2 REST API, and supports any combination of API versions you might use for each of the PCO apps.


import pypco
pco = pypco.PCO("<app_id>", "<app_secret>")

# Print first and last names of everyone in People
for person in pco.iterate('/people/v2/people'):
    print(f'{person["data"]["attributes"]["first_name"]} '\

# Create, save, and print a new person's attribs
payload = pco.template(
  {'first_name': 'John', 'last_name': 'Doe'}
new_person ='/people/v2/people', payload)

# Change our new person's last name and print attribs
payload = pco.template(
  {'last_name': 'Smith'}
updated_person = pco.patch(

# Add an email address for our person
payload = pco.template(
    'address': '',
    'location': 'Home'
email_object =

# Iterate through our person's email addresses
for email in pco.iterate(

Version 1.0

Code written for pypco v0 will not be compatible with the v1 release. Because of changes in the PCO API (primarily the introduction of versioning) and the need for significantly improved performance, v1 is almost a complete rewrite. The result is a much more flexible, performant, and robust API wrapper. Though perhaps a bit less "pythonic", pypco v1.0.x will be much more maintainable going forward.

If you're relying on pypco v0, you can still find the source code here. Development will not continue on the v0 release, but feel free to submit an issue if you're relying on v0 and need help with a specific problem.


Pypco is licensed under the terms of the MIT License.

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

pypco-1.2.0.tar.gz (12.7 kB view hashes)

Uploaded Source

Built Distribution

pypco-1.2.0-py3-none-any.whl (12.4 kB view hashes)

Uploaded Python 3

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