Skip to main content

A Python wrapper for the Calendly API (https://developer.calendly.com/docs/)

Project description

CircleCI

calendly-python 🐍

Python package to use the Calendly API 🚀

Installation

pip install calendly

Usage

Set your Authentication token

See Calendly docs to get your auth token

from calendly import Calendly
calendly = Calendly(api_key)

Test the auth token

calendly.echo()

Webhooks

Create A Webhook Subscription
calendly.create_webhook('https://your-webhook.com', events=['canceled', 'invited'])
  • Note: the events variable is a list
  • Note: possible values are: canceled and invited
  • Note: by default the events list contains the 2 possible values
Get Webhook Subscription
calendly.get_webhook('webhook_id')
Get List of Webhook Subscriptions
calendly.list_webhooks()
Delete Webhook Subscription
calendly.remove_webhook('webhook_id')
  • Note: the response will be {'success': True} if the webhook was successfully removed, otherwise it will be {'success': False, "type": "calendly type", "message": "reason it failed"}

User Event Types

calendly.event_types()

About Me

calendly.about()

Important

  • Note: All the responses are dictionaries with the calendly response, except for the remove webhook method that also contains the success key. Check their docs to know the possible responses!

TODOs:

Next steps for this package:

  • Improve how the methods return the responses: proccess Calendly responses and make them objects, so that users can manage the information in an easier way
  • Support for version 2 <3
  • Creating reusable exceptions for error messages

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

calendly-1.1.1.tar.gz (3.0 kB view hashes)

Uploaded source

Built Distribution

calendly-1.1.1-py3-none-any.whl (4.5 kB view hashes)

Uploaded py3

Supported by

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