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.

Source Code: View on GitHub

Authentication

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

Supported authentication methods:

  • OAuth Browser Flow (recommended for UI)

  • OAuth Token (for programmatic access)

  • Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

MondayBoardEntity

Schema for Monday Board objects.

Field
Type
Description

board_id

str

Unique identifier for the board.

board_name

str

Display name of the board.

created_time

Optional[datetime]

Board creation timestamp (if available).

updated_time

Optional[datetime]

Board update timestamp.

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).

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).

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'.

workspace_id

Optional[str]

The unique identifier of the workspace containing this board (if any).

web_url_value

Optional[str]

URL to view the board in Monday.

MondayGroupEntity

Schema for Monday Group objects.

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

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.

web_url_value

Optional[str]

URL to view the group in Monday.

MondayColumnEntity

Schema for Monday Column objects.

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

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.

web_url_value

Optional[str]

URL to view the column in Monday.

MondayItemEntity

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

Field
Type
Description

item_id

str

The unique identifier (ID) of the item.

item_name

str

Display name of the item.

created_time

Optional[datetime]

When the item was created.

updated_time

Optional[datetime]

When the item was updated.

board_id

str

ID of the board this item belongs to.

group_id

Optional[str]

ID of the group this item is placed in.

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.

web_url_value

Optional[str]

URL to view the item in Monday.

MondaySubitemEntity

Schema for Monday Subitem objects.

Field
Type
Description

subitem_id

str

The unique identifier (ID) of the subitem.

subitem_name

str

Display name of the subitem.

created_time

Optional[datetime]

When the subitem was created.

updated_time

Optional[datetime]

When the subitem was updated.

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.

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.

web_url_value

Optional[str]

URL to view the subitem in Monday.

MondayUpdateEntity

Schema for Monday Update objects.

Field
Type
Description

update_id

str

The unique identifier (ID) of the update.

update_preview

str

Preview text for the update body.

created_time

Optional[datetime]

When the update was created.

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.

assets

List[Dict]

Assets (e.g. images, attachments) associated with this update.

web_url_value

Optional[str]

URL to view the update in Monday.

Last updated