Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gearplug/calendly-python
calendly-python is an API wrapper for Calendly, written in Python
https://github.com/gearplug/calendly-python
api calendar calendly events oauth2 python webhooks wrapper
Last synced: 3 days ago
JSON representation
calendly-python is an API wrapper for Calendly, written in Python
- Host: GitHub
- URL: https://github.com/gearplug/calendly-python
- Owner: GearPlug
- License: mit
- Created: 2022-12-22T19:30:32.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-28T14:22:43.000Z (over 1 year ago)
- Last Synced: 2023-05-25T02:06:13.774Z (over 1 year ago)
- Topics: api, calendar, calendly, events, oauth2, python, webhooks, wrapper
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
 
# calendly-python
calendly-python is an API wrapper for Calendly, written in Python
## Installing
```
pip install calendly-python
```
## Usage
```
from calendly.client import Client
client = Client('access_token')
user_uri = client.user_uri
user_uuid = client.user_uuid
organization_uri = client.organization_uri
organization_uuid = client.organization_uuid
```
If you don't have access_token you can get one using Oauth2, following the next steps:
Check https://developer.calendly.com/how-to-authenticate-with-oauth, for more info.
1. Initiate client:
```
client = Client(client_id="client_id", client_secret="client_secret", redirect_uri="redirect_uri")
```
2. Get authorization URL to get code
```
url = client.authorization_url()
```
3. Get access token using code
```
response = client.get_access_token(code)
```
4. Set access token
```
client.set_token(access_token)
```
If your access token expired, you can get a new one using refresh_token:
```
response = client.refresh_access_token(refresh_token)
```
And then set access token again...
#### Current User
```
current_user = client.get_current_user()
```
#### Get Scheduled Event
```
event = client.get_scheduled_event(event_uuid)
```
### Webhooks
#### Create webhook
```
webhook = client.create_webhook(self, url, events, organization_uri, user_uri, scope)
# events: must be a list of valid events (check calendly API)
# scope: two options: "user" or "organization"
```
#### List webhooks
```
webhooks = client.list_webhooks(self, scope, organization_uri, user_uri=None)
# scope: two options: "user" or "organization"
# Note: must send user_uri if scope = "user"
```
#### Delete webhook
```
client.delete_webhook(webhook_uuid)
```