Monday

Configuration

Monday source connector integrates with the Monday.com GraphQL API to extract work data.

Connects to your Monday.com workspace.

It provides comprehensive access to boards, items, and team collaboration features with full relationship mapping and custom field support.

Explore the Monday connector implementation

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

This connector does not have any additional configuration options.

The following data models are available for this connector:

Schema for Monday Board objects.

Field	Type	Description
board_id	str	The unique identifier (ID) of the board.
board_kind	Optional[str]	The board’s kind/type: ‘public’, ‘private’, or ‘share’.
columns	List[Dict]	A list of columns on the board (each column is typically a dict of fields).
created_at	Optional[datetime]	When the board was first created.
description	Optional[str]	The description of the board.
groups	List[Dict]	A list of groups on the board (each group is typically a dict of fields).
name	Optional[str]	The display name/title of the board.
owners	List[Dict]	A list of users or teams who own the board.
state	Optional[str]	The board’s current state: ‘active’, ‘archived’, or ‘deleted’.
updated_at	Optional[datetime]	When the board was last updated.
workspace_id	Optional[str]	The unique identifier of the workspace containing this board (if any).

Schema for Monday Group objects.

Groups are collections of items (rows) within a board.

Field	Type	Description
group_id	str	The unique identifier (ID) of the group.
board_id	str	ID of the board this group belongs to.
title	Optional[str]	Title or display name of the group.
color	Optional[str]	Group color code (e.g., ‘red’, ‘green’, ‘blue’, etc.).
archived	bool	Whether this group is archived.
items	List[Dict]	List of items (rows) contained within this group.

Schema for Monday Column objects.

Columns define the structure of data on a Monday board.

Field	Type	Description
column_id	str	The unique identifier (ID) of the column.
board_id	str	ID of the board this column belongs to.
title	Optional[str]	The display title of the column.
column_type	Optional[str]	The type of the column (e.g., ‘text’, ‘number’, ‘date’, ‘link’).
description	Optional[str]	The description of the column.
settings_str	Optional[str]	Raw settings/configuration details for the column.
archived	bool	Whether this column is archived or hidden.

Schema for Monday Item objects (rows on a board).

Field	Type	Description
item_id	str	The unique identifier (ID) of the item.
board_id	str	ID of the board this item belongs to.
group_id	Optional[str]	ID of the group this item is placed in.
name	Optional[str]	The display name/title of the item.
state	Optional[str]	The current state of the item: active, archived, or deleted.
column_values	List[Dict]	A list of column-value dicts that contain the data for each column.
creator	Optional[Dict]	Information about the user/team who created this item.
created_at	Optional[datetime]	When the item was first created.
updated_at	Optional[datetime]	When the item was last updated.

Schema for Monday Subitem objects.

Subitems are items nested under a parent item, often in a dedicated ‘Subitems’ column.

Field	Type	Description
subitem_id	str	The unique identifier (ID) of the subitem.
parent_item_id	str	ID of the parent item this subitem belongs to.
board_id	str	ID of the board that this subitem resides in.
group_id	Optional[str]	ID of the group this subitem is placed in.
name	Optional[str]	The display name/title of the subitem.
state	Optional[str]	The current state of the subitem: active, archived, or deleted.
column_values	List[Dict]	A list of column-value dicts for each column on the subitem.
creator	Optional[Dict]	Information about the user/team who created this subitem.
created_at	Optional[datetime]	When the subitem was first created.
updated_at	Optional[datetime]	When the subitem was last updated.

Schema for Monday Update objects.

monday.com updates add notes and discussions to items outside of their column data.

Field	Type	Description
update_id	str	The unique identifier (ID) of the update.
item_id	Optional[str]	ID of the item this update is referencing (could also be a board-level update).
board_id	Optional[str]	ID of the board, if applicable.
creator_id	Optional[str]	ID of the user who created this update.
body	Optional[str]	The text (body) of the update, which may include markdown or HTML formatting.
created_at	Optional[datetime]	When the update was first created.
assets	List[Dict]	Assets (e.g. images, attachments) associated with this update.