View as Markdown
monday icon

monday ACTION

List Columns

List the columns of a board, including each column's ID, type, and the labels a status or dropdown column accepts. Use this to discover the column IDs and values required by Create Item, Update Column Values and Get Items By Column Value. Set Board ID. Example: returns e.g. [{ "id": "status", "title": "Status", "type": "status", "labels": ["Done", "Working on it"] }]; labels is absent for column types that do not use them. Not paginated — every column on the board is returned. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's monday account once, then configure and run List Columns from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "monday-list-columns",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    monday: { authProvisionId: "apn_xxxxxxx" },
    boardId: "Board ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Columns inputs
Property Type Description
boardId Board ID string
The board to act on, as a board ID (e.g. 2419687965). Use List Board ID Options to look up a board ID by name.
Required Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
monday-list-columns
Version
0.0.1
App
monday
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes