Skip to main content

A Python wrapper for Schoology's API.

Project description

Python wrapper for Schoology’s API.


You may easily install schoolopy from PyPI with pip3 install schoolopy.

Setup & Authorization

Before any use of schoolopy, you’ll need to import it.

import schoolopy

You’ll then need to instantiate the Auth class and, using that object, instantiate the API wrapper. There are two ways of authenticating with Schoology: two-legged and three-legged. The former is far simpler and useful for apps used by only one user who is capable of managing their own API keys, but if you’re building a web app to interact with Schoology you’ll need to use three-legged.

Obtain your consumer API key and secret from [Schoology URL]/api.

# Two-legged
sc = schoolopy.Schoology(schoolopy.Auth(key, secret))
sc.get_feed()  # etc.
# Three-legged
auth = schoolopy.Auth(key, secret, three_legged=True, domain='')  # Replace URL with that of your school's Schoology
url = auth.request_authorization()
# Redirect user to that URL as appropriate for your application. Once user has performed action, continue.
if not auth.authorize():
    raise SystemExit('User not authorized!')
sc = schoolopy.Schoology(auth)


More in-depth examples of both two- and three-legged authentication in action can be found in and You will need to write your key and secret into example_config.yml.example and rename that file to example_config.yml.


This library contains a large number of functions for interaction with the API, and listing them all would be impractical.

For a comprehensive list of what endpoints are available, consult the REST API v1 documentation.

Most objects’ functions follow a similar pattern to the following example.

[realm] represents the name of any realm type; in this case you can use district, school, user, section, or group. Valid realms may vary for different objects.

event represents an Event object.

  • sc.get_events([realm]_id=)

  • sc.get_[realm]_events([realm]_id)

  • sc.create_event(event, [realm]_id=)

  • sc.create_[realm]_event(event, [realm]_id)

  • sc.get_event(event_id, [realm]_id=)

  • sc.get_[realm]_events([realm]_id)

  • sc.update_event(event, event_id, [realm]_id=)

  • sc.update_[realm]_event(event, event_id, [realm]_id)

  • sc.delete_event(event_id, [realm]_id=)

  • sc.delete_[realm]_event(event_id, [realm]_id)

Note: Some methods, such as `get_courses`, are currently broken because Schoology’s API has stopped providing data on the relevant endpoints.


This library was created by Erik Boesen.


This software is available under 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

schoolopy-0.3.1.tar.gz (17.0 kB view hashes)

Uploaded Source

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