Monday.com Integration

Overview

Add Monday.com to any ModuleX agent or workflow. Work management platform for creating and managing boards, items, columns, groups, and updates via the Monday.com GraphQL API (api.monday.com/v2).

Categories: Project & Task Management · Productivity & Collaboration · Project Management · Auth: OAuth2, API Key · Actions: 13

Authentication

OAuth2
API Key

OAuth2 Authentication

Connect using Monday.com OAuth (recommended for most use cases)

Required Credentials

Field	Description	Required	Format
Client ID	Monday.com OAuth App Client ID	Yes	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
Client Secret	Monday.com OAuth App Client Secret	Yes	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

OAuth Configuration

Authorization URL: https://auth.monday.com/oauth2/authorize
Token URL: https://auth.monday.com/oauth2/token
Scopes: me:read, boards:read, boards:write, workspaces:read

API Key Authentication

Authenticate using your Monday.com API token

Step 1

Step 2

Click your avatar (bottom left) and select ‘Developers’

Step 3

Go to ‘My Access Tokens’ section

Step 4

Copy your personal API token or generate a new one

Required Credentials

Field	Description	Required	Format
Monday.com API Token	Your personal API token from Monday.com developer settings	Yes	`eyJhbGciOiJIUzI1NiJ9...`

Available Actions

create_board — Creates a new board

Parameters

string

required

The new board’s name

string

required

The new board’s kind: public, private, or share

integer

Workspace ID to create the board in. If not specified, the Main Workspace is used

integer

Folder ID to create the board in

integer

Template board ID to use for the new board

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateBoardOutput",
  "type": "object"
}

create_column — Creates a column in a board

Parameters

string

required

The ID of the board to create the column in

string

required

The title of the new column

string

required

The type of column: auto_number, checkbox, country, color_picker, creation_log, date, dependency, dropdown, email, file, hour, item_id, last_updated, link, location, long_text, numbers, people, phone, progress, rating, status, team, tags, text, timeline, time_tracking, vote, week, world_clock

string

Custom labels JSON for status/dropdown columns, e.g. {“1”: “Technology”, “2”: “Marketing”}

string

Description of the new column

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateColumnOutput",
  "type": "object"
}

create_group — Creates a new group in a specific board

Parameters

string

required

The ID of the board to create the group in

string

required

The name of the new group

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateGroupOutput",
  "type": "object"
}

create_item — Creates an item in a board

Parameters

string

required

The ID of the board to create the item in

string

required

The new item’s name

string

Group ID to create the item in

boolean

Create Status/Dropdown labels if missing (requires permission to change board structure)

string

JSON string of column values for the new item. See Monday.com Column Type Reference for format details

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateItemOutput",
  "type": "object"
}

create_subitem — Creates a subitem under a parent item

Parameters

string

required

The ID of the board containing the parent item

string

required

The ID of the parent item to create the subitem under

string

required

The new subitem’s name

string

JSON string of column values for the new subitem

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateSubitemOutput",
  "type": "object"
}

create_update — Creates a new update (comment) on an item

Parameters

string

required

The ID of the board containing the item

string

required

The ID of the item to add the update to

string

required

The update text content

string

The ID of a parent update to reply to

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateUpdateOutput",
  "type": "object"
}

get_board_items_page — Retrieves items from a board with optional filtering

Parameters

string

required

The ID of the board to retrieve items from

string

JSON object with filter/sort parameters in ItemsQuery format

integer

Maximum number of pages to fetch (default 50) (Default: 50)

Response

{
  "$defs": {
    "ColumnValue": {
      "additionalProperties": false,
      "description": "A column value returned for an item.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        }
      },
      "title": "ColumnValue",
      "type": "object"
    },
    "ItemSummary": {
      "additionalProperties": false,
      "description": "An item returned from a Monday.com board.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "column_values": {
          "items": {
            "$ref": "#/$defs/ColumnValue"
          },
          "title": "Column Values",
          "type": "array"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created At"
        },
        "creator_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Creator Id"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "relative_link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Relative Link"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Updated At"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        }
      },
      "title": "ItemSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "items": {
      "items": {
        "$ref": "#/$defs/ItemSummary"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetBoardItemsPageOutput",
  "type": "object"
}

get_column_values — Returns values of specific columns for a board item

Parameters

string

required

The ID of the board

string

required

The ID of the item to retrieve column values from

array

List of column IDs to retrieve. If empty, returns all columns. Element type: string

Response

{
  "$defs": {
    "ColumnValue": {
      "additionalProperties": false,
      "description": "A column value returned for an item.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        }
      },
      "title": "ColumnValue",
      "type": "object"
    },
    "ItemSummary": {
      "additionalProperties": false,
      "description": "An item returned from a Monday.com board.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "column_values": {
          "items": {
            "$ref": "#/$defs/ColumnValue"
          },
          "title": "Column Values",
          "type": "array"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created At"
        },
        "creator_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Creator Id"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "relative_link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Relative Link"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Updated At"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        }
      },
      "title": "ItemSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "items": {
      "items": {
        "$ref": "#/$defs/ItemSummary"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetColumnValuesOutput",
  "type": "object"
}

get_items_by_column_value — Searches a column for items matching a specific value

Parameters

string

required

The ID of the board to search in

string

required

The ID of the column to search

string

required

The value to search for in the specified column

integer

Maximum number of pages to fetch (default 50) (Default: 50)

Response

{
  "$defs": {
    "ColumnValue": {
      "additionalProperties": false,
      "description": "A column value returned for an item.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        }
      },
      "title": "ColumnValue",
      "type": "object"
    },
    "ItemSummary": {
      "additionalProperties": false,
      "description": "An item returned from a Monday.com board.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "column_values": {
          "items": {
            "$ref": "#/$defs/ColumnValue"
          },
          "title": "Column Values",
          "type": "array"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created At"
        },
        "creator_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Creator Id"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "relative_link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Relative Link"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Updated At"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        }
      },
      "title": "ItemSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "items": {
      "items": {
        "$ref": "#/$defs/ItemSummary"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetItemsByColumnValueOutput",
  "type": "object"
}

list_boards — Lists boards with optional filters for kind, state, and workspace

Parameters

array

Filter to specific board IDs. Element type: string

array

Filter to boards in specific workspace IDs. Element type: integer

string

Filter by board kind: public, private, or share

string

Filter by state: active, archived, deleted, or all (Default: all)

string

Sort by: created_at or used_at (Default: created_at)

integer

Maximum number of boards to return per page (Default: 25)

integer

Page number to return (Default: 1)

Response

{
  "$defs": {
    "MondayBoard": {
      "additionalProperties": false,
      "description": "A board object from Monday.com.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "board_kind": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Board Kind"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "workspace_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Workspace Id"
        }
      },
      "title": "MondayBoard",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "boards": {
      "items": {
        "$ref": "#/$defs/MondayBoard"
      },
      "title": "Boards",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListBoardsOutput",
  "type": "object"
}

list_workspaces — Retrieves available workspaces with their IDs and names

Response

{
  "$defs": {
    "WorkspaceOption": {
      "additionalProperties": false,
      "description": "A workspace option with label and value.",
      "properties": {
        "label": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Label"
        },
        "value": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        }
      },
      "title": "WorkspaceOption",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "workspaces": {
      "items": {
        "$ref": "#/$defs/WorkspaceOption"
      },
      "title": "Workspaces",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListWorkspacesOutput",
  "type": "object"
}

update_column_values — Updates multiple column values for an item

Parameters

string

required

The ID of the board containing the item

string

required

The ID of the item to update

string

required

JSON string of column values to update. Keys are column IDs, values are new values per Column Types Reference

Response

{
  "$defs": {
    "ColumnValue": {
      "additionalProperties": false,
      "description": "A column value returned for an item.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        }
      },
      "title": "ColumnValue",
      "type": "object"
    },
    "ItemSummary": {
      "additionalProperties": false,
      "description": "An item returned from a Monday.com board.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "column_values": {
          "items": {
            "$ref": "#/$defs/ColumnValue"
          },
          "title": "Column Values",
          "type": "array"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created At"
        },
        "creator_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Creator Id"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "relative_link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Relative Link"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Updated At"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        }
      },
      "title": "ItemSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "items": {
      "items": {
        "$ref": "#/$defs/ItemSummary"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateColumnValuesOutput",
  "type": "object"
}

update_item_name — Updates an item's name

Parameters

string

required

The ID of the board containing the item

string

required

The ID of the item to rename

string

required

The new item name

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateItemNameOutput",
  "type": "object"
}

Limits & Quotas

Rate limits: Monday.com uses a complexity-based rate limit system. Each query has a complexity cost; the default limit is 10,000,000 complexity points per minute.
Pagination: Board items are paginated with a default page size of 500 items per request. The integration handles cursor-based pagination internally for get_board_items_page and get_items_by_column_value.
Error model: GraphQL errors and non-2xx responses are caught and returned as success=False + error rather than raising.

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​API Key Authentication

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Jira

ClickUp

Motion

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links