monday-python
monday-python is an API wrapper for monday.com, written in Python.
This library includes notifications using webhooks.
Installing
pip install monday-python
Usage
from monday.client import Client
client = Client(api_token)Find your API token in your monday.com profile admin settings API section.
- Get current user
user = client.get_current_user()- List users
users = client.list_users()- List workspaces
workspaces = client.list_workspaces()- List boards
boards = client.list_boards(workspace_id)- List columns
cols = client.list_columns(board_id)Items
- List items
items = client.list_items(board_id)- Get item
item = client.get_item(item_id)- Get items by column values
# The item's state: all, active, archived, or deleted. The default state is active.
items = client.get_items_by_column_values(board_id, column_id, column_value, limit=50, state="active")- Create item
# column_values is a dictionary with the following structure:
# {"column_id": "column_value", "column_id": "column_value"}
item = client.create_item(board_id, item_name: str, column_values: dict = None)- Update item
# column_values is a dictionary with the following structure:
# {"column_id": "column_value", "column_id": "column_value"}
item = client.update_item(board_id, item_id, column_values)Webhooks
- List webhooks
webhooks = client.list_webhooks(board_id)- Create webhook
webhook = client.create_webhook(board_id, url, event)To activate a webhook, the URL must return a response to a post request that monday.com will send to verify.
Read more about it here: https://developer.monday.com/api-reference/docs/webhooks
- Delete a webhook
deleted = client.delete_webhook(webhook_id)