View as Markdown
monday icon

monday ACTION

Create Group

Create 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 optional Group ID. Set Board ID and Group Name. Example: Board ID 2419687965, Group Name In Progress. Returns the new group's ID as a string (e.g. new_group12345) — pass that value as Group ID to Create Item. Use List Board ID Options to find a valid Board ID. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's monday account once, then configure and run Create Group 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-create-group",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    monday: { authProvisionId: "apn_xxxxxxx" },
    boardId: "Board ID",
    groupName: "Group Name",
  },
})

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.

Create Group 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
groupName Group Name string
The name of the new group
Required

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-create-group
Version
0.0.17
App
monday
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes