Monday Tools

The Monday provider lets a workflow read and write data in Monday.com through its GraphQL API. Use these tools to list boards, fetch items from a board, create new items, and update a single column value on an existing item.

Overview

Operations

All operations send a POST request to https://api.monday.com/v2 with the headers Authorization: <apiKey>, Content-Type: application/json, and API-Version: 2024-01. The request body is a GraphQL query/mutation.

Configuration

monday_list_boards

List boards from your Monday.com account.

monday_get_board_items

Get items from a Monday.com board (each item includes its column_values).

monday_create_item

Create a new item on a Monday.com board.

monday_update_item

Update a single column value of an item on a Monday.com board.

Outputs

monday_list_boards

• data (json) — Array of Monday.com board objects (each with id and name).
• metadata (json) — List metadata.
  • count (number) — Number of boards returned.

monday_get_board_items

• data (json) — Array of Monday.com item objects (each with id, name, and column_values containing id, text, value).
• metadata (json) — List metadata.
  • count (number) — Number of items returned.

monday_create_item

• data (json) — The created Monday.com item object (id, name).
• metadata (json) — Item identifiers.
  • id (string) — Item ID.

monday_update_item

• data (json) — The updated Monday.com item object (id, name).
• metadata (json) — Item identifiers.
  • id (string) — Item ID.

YAML Example

monday_1:
  type: monday
  name: "Monday"
  inputs:
    operation: "monday_list_boards"
    limit: 25
    apiKey: "{{MONDAY_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Create an item on a specific board:

monday_create:
  type: monday
  name: "Monday Create Item"
  inputs:
    operation: "monday_create_item"
    boardId: "1234567890"
    itemName: "New item from workflow"
    apiKey: "{{MONDAY_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

To use the created item's ID in a later block, reference it with double braces, e.g. {{monday_create.metadata.id}}.

Tips

• Auth setup: Generate a personal API token in Monday.com under your avatar → Developers → My Access Tokens, then store it as the apiKey. It is sent directly in the Authorization header (no Bearer prefix). Keep it in an environment variable and reference it as {{MONDAY_API_KEY}} rather than hard-coding it.
• Finding IDs: Run monday_list_boards first to discover board IDs, then monday_get_board_items to discover item IDs and column IDs (each item's column_values exposes the id you pass as columnId).
• Limit defaults: Both monday_list_boards and monday_get_board_items default to returning 25 results when limit is omitted; raise it if you need more.
• Update is single-column: monday_update_item updates exactly one column via change_simple_column_value. The value is a simple string — for complex column types you may need a value Monday accepts for that column (e.g. a label for a status column).