CONNECT APP
Build with monday
Productivity
- API key
MCP
Give your agent monday tools
Every monday action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's monday account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "monday",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Create an Update:
const result = await mcp.callTool({
name: "monday-create-update",
arguments: {
updateBody: "Update Body",
boardId: "Board ID",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "monday",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Create an Update:
result = await session.call_tool("monday-create-update", {
"updateBody": "Update Body",
"boardId": "Board ID",
})API PROXY
Call the monday API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the monday API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.monday.com/v2",
})
// Any allowed monday endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.monday.com/v2
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkubW9uZGF5LmNvbS92Mg?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run monday actions from your backend
Connect a user's monday account once, then run Create an Update on their behalf from your own code — TypeScript, Python, or plain HTTP.
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-create-update",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
monday: { authProvisionId: "apn_xxxxxxx" },
updateBody: "Update Body",
boardId: "Board ID",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="monday-create-update",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"monday": {"authProvisionId": "apn_xxxxxxx"},
"updateBody": "Update Body",
"boardId": "Board ID",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "monday-create-update",
"configured_props": {
"monday": { "authProvisionId": "apn_xxxxxxx" },
"updateBody": "Update Body",
"boardId": "Board ID"
}
}'TOOLS
monday actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Create an Update
actionPost an update (a comment) on an item, or reply to an existing update. Use to add a note to an item's activity feed; this changes no column value — use Update Column Values for that. SetBoard ID,Item IDandUpdate Body, and setParent Update IDonly when replying to an existing update rather than starting a new thread. Example: Update BodyDesign approved, moving to build. Returns the new update's ID as a string. Use Get Board Items Page to find anItem ID. See the documentationWritev0.0.19 -
Create Board
actionCreate a new board in a workspace. Use when you need a new board before adding groups, columns or items to it. SetBoard NameandBoard Kind(public,privateorshare); if you omitWorkspace IDthe board is created in the Main Workspace. Example: Board NameQ3 Campaigns, Board Kindpublic. Returns the new board's ID as a string (e.g.2419687965), not the full board object — call List Boards if you need its details. Use List Workspace ID Options to find a validWorkspace ID. See the documentationWritev0.0.16 -
Create Column
actionAdd a column to an existing board. Use when a board is missing a field you need before setting values with Create Item or Update Column Values. SetBoard ID,TitleandColumn Type(e.g.status,text,date,numbers).Custom Labels (Defaults)is accepted only whenColumn Typeisstatusordropdownand is rejected for any other type. Example: TitlePriority, Column Typestatus, Custom Labels{ "1": "High", "2": "Low" }. Returns the new column's ID as a string (e.g.status_1). Call List Columns afterwards to confirm the ID and the labels it accepts. See the documentationWritev0.1.8 -
Create Group
actionCreate a group (a titled section of rows) on a board. Use when you need somewhere to put new rows before calling Create Item, which takes an optionalGroup ID. SetBoard IDandGroup Name. Example: Board ID2419687965, Group NameIn Progress. Returns the new group's ID as a string (e.g.new_group12345) — pass that value asGroup IDto Create Item. Use List Board ID Options to find a validBoard ID. See the documentationWritev0.0.17 -
Create Item
actionCreate an item (a row) on a board. Use for a top-level row; use Create Subitem for a row nested under an existing item. SetBoard IDandItem Name, and optionallyGroup IDandColumn Values. Call List Columns first to get the column IDs and the labels astatusordropdowncolumn accepts. Example: Item NameWebsite redesign, Column Values{ "status": "Working on it", "date4": "2026-09-02", "numbers": 42 }. SetItem Create Labelstotrueto allow missingstatus/dropdownlabels to be created, which requires permission to change the board structure. Returns the new item's ID as a string (e.g.9876543210). See the documentationWritev0.1.9 -
Create Subitem
actionCreate a subitem nested under an existing item. Use when the row belongs to a parent item; use Create Item for a top-level row. SetBoard ID(the parent item's board),Parent Item IDandItem Name. Gotcha: subitems live on a separate subitems board, soColumn Valuesmust use that board's column IDs — run List Columns against the subitems board, not the board selected here. Example: Item NameDraft copy, Column Values{ "status": "Done" }. Returns the new subitem's ID as a string. See the documentationWritev0.1.9 -
Get Board Items Page
actionList every item (row) on a board, following the API's cursor automatically so all pages are returned in a single call — you do not need to paginate. Use when you want the whole board; use Get Items By Column Value to filter server-side by one column, which is far cheaper on a large board. SetBoard ID, and optionallyQuery Paramsto filter or sort. Example: Query Params{ "rules": [{ "column_id": "status", "compare_value": ["Done"], "operator": "any_of" }] }. Returns an array of items withid,name,state, timestamps and column values. Gotcha: a large board returns every row in one response, so expect a slow call and a large payload. See the documentationRead-onlyv0.0.7 -
Get Column Values
actionRead the column values of one item. Use when you already have anItem IDand want its field values; use Get Items By Column Value to search for items by a value instead. SetBoard IDandItem ID; leaveColumn IDsempty to return every column, or pass specific column IDs from List Columns. Example: Item ID9876543210, Column IDs["status", "date4"]. Returns an array holding the item and acolumn_valuesarray of{ id, value }pairs, wherevalueis the column's display text when one exists and the raw JSON value otherwise. See the documentationRead-onlyv0.0.14 -
Get Items By Column Value
actionFind every item on a board whose column matches a value, following the API's cursor automatically so all matches are returned in a single call. Use to look up items by a field instead of pulling the whole board with Get Board Items Page. SetBoard ID,ColumnandValue. For astatusordropdowncolumn pass the label text rather than its ID — call List Columns to see the labels a column accepts. Example: Columnstatus, ValueDone. Returns an array of matching items, each with acolumn_valuesarray of{ id, value }pairs; an empty array means nothing matched. Gotcha: not every column type is searchable this way. See the documentationRead-onlyv0.1.8 -
List Board ID Options
actionList the account's boards as{ value, label }option pairs, to discover aBoard IDto pass to other actions. Use when you know a board by name but need its ID; use List Boards when you want each board's full details instead. Example: call with Page1; returns e.g.[{ "value": "2419687965", "label": "Q3 Campaigns" }]. Returns at most 25 options per page, so if exactly 25 come back there are probably more — call again withPageincremented by 1. Sub-items boards are excluded. See the documentationRead-onlyv0.0.4 -
List Board IDs Options
actionList the account's boards as{ value, label }option pairs, to discover theBoard IDsto pass to actions that filter across several boards, such as List Boards. Use when you know boards by name but need their IDs. Example: call with Page1; returns e.g.[{ "value": "2419687965", "label": "Q3 Campaigns" }]. Returns at most 25 options per page, so if exactly 25 come back there are probably more — call again withPageincremented by 1. Sub-items boards are excluded. See the documentationRead-onlyv0.0.4 -
List Boards
actionList boards with their full details — columns, groups, owners, subscribers, tags and workspace. Use when you need board metadata; use List Board ID Options when you only need an ID and a name, which returns a far smaller response. Narrow the results withBoard IDs,Workspace IDs,Board KindandState. Example: Limit25, Page1, Stateactive. Returns an array of board objects. If exactlyLimitboards come back there are probably more — call again withPageincremented by 1. See the documentationRead-onlyv0.0.4 -
List Columns
actionList the columns of a board, including each column's ID, type, and the labels astatusordropdowncolumn accepts. Use this to discover the column IDs and values required by Create Item, Update Column Values and Get Items By Column Value. SetBoard ID. Example: returns e.g.[{ "id": "status", "title": "Status", "type": "status", "labels": ["Done", "Working on it"] }];labelsis absent for column types that do not use them. Not paginated — every column on the board is returned. See the documentationRead-onlyv0.0.1 -
List Updates
actionList the updates (comments) posted on a board's items, including each update's ID, body and author. Use this to discover theParent Update IDrequired by Create an Update when replying to an existing update. SetBoard ID. Example: Limit25, Page1. Returns an array of update objects, each carrying theitem_idof the item it was posted on. If exactlyLimitupdates come back there are probably more — call again withPageincremented by 1. See the documentationRead-onlyv0.0.1 -
List Workspace ID Options
actionList the account's workspaces as{ value, label }option pairs, to discover aWorkspace IDto pass to Create Board or to filter List Boards. Use when you know a workspace by name but need its ID. Example: call with Page1; returns e.g.[{ "value": 12345, "label": "Marketing" }]. Returns at mostLimitworkspaces per page (25 by default), so if exactlyLimitcome back there are probably more — call again withPageincremented by 1. See the documentationRead-onlyv0.0.4 -
List Workspace IDs Options
actionList the account's workspaces as{ value, label }option pairs, to discover theWorkspace IDsto pass to actions that filter across several workspaces, such as List Boards. Use when you know workspaces by name but need their IDs. Example: call with Page1; returns e.g.[{ "value": 12345, "label": "Marketing" }]. Returns at mostLimitworkspaces per page (25 by default), so if exactlyLimitcome back there are probably more — call again withPageincremented by 1. See the documentationRead-onlyv0.0.4 -
Update Column Values
actionSet one or more column values on an existing item. Use for any field change except the item's name — this mutation cannot change it, so use Update Item Name for that. SetBoard ID,Item IDandColumn Valuesas column ID to value pairs; call List Columns first for the column IDs and the labels astatus/dropdowncolumn accepts. Example: Column Values{ "status": "Done", "date4": "2026-09-02", "numbers": 42 }. Afilecolumn takes a file URL or a path under/tmpand is uploaded in a separate request. Every column ID is checked against the board before anything is sent, so a call that names an unknown column fails without changing the item. Returns the updated item with itscolumn_values. See the documentationWritev0.2.10 -
Update Item Name
actionRename an existing item. Use for the item's name only — Update Column Values cannot change it, and this action changes nothing else. SetBoard ID,Item IDand the newItem Name. Example: Item ID9876543210, Item NameWebsite redesign v2. Returns the item's ID as a string. Use Get Board Items Page or Get Items By Column Value to find anItem ID. See the documentationWritev0.0.18
-
Column Value Updated (Instant)
triggerEmit new event when a column value is updated on a board. See the documentationInstantv0.0.15 -
Name Updated (Instant)
triggerEmit new event when an item's name is updated. See the documentationInstantv0.0.15 -
New Board Created
triggerEmit new event when a board is created in Monday. See the documentationv0.0.16 -
New Item Created (Instant)
triggerEmit new event when a new item is added to a board. See the documentationInstantv0.0.15 -
New Sub-Item Created (Instant)
triggerEmit new event when a sub-item is created. See the documentationInstantv0.0.14 -
New Sub-Item Update (Instant)
triggerEmit new event when an update is posted in sub-items. See the documentationInstantv0.0.14 -
New User Created
triggerEmit new event when a new user is created in Monday. See the documentationv0.0.16 -
Specific Column Updated (Instant)
triggerEmit new event when a value in the specified column is updated. See the documentationInstantv0.0.15 -
Sub-Item Column Value Updated (Instant)
triggerEmit new event when any sub-item column changes. See the documentationInstantv0.0.15 -
Sub-Item Name Updated (Instant)
triggerEmit new event when a sub-item name changes. See the documentationInstantv0.0.14
MULTI-APP
Use monday with other popular apps
Most products don't stop at one integration. Pair monday with the other apps your users rely on, and ship use cases that span both.
- App slug
- monday
- Authentication
- API key
- Categories
- Productivity
- Actions
- 18
- Triggers
- 10
- API proxy
- Available