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)

muhsajjad / monday-python