cotera
Logo

Monday.com

Authentication Type: API Key Description: Project management platform for managing boards, items, groups, and column values through Monday.com's GraphQL API.

Authentication

To authenticate, you'll need a Monday.com API token. Learn how to create one in the Monday.com documentation.

You can find your API token in: Profile Picture > Developers > My Access Tokens.

Boards

Operations for managing Monday.com boards.

List Boards

List all accessible boards with optional filtering by state, kind, and workspace.

Operation Type: Query (Read)

Parameters:

  • state string (nullable): Filter by board state (active, archived, deleted, all). Defaults to active
  • boardKind string (nullable): Filter by board kind (public, private, share)
  • workspaceIds array of numbers (nullable): Filter by workspace IDs
  • limit number (nullable): Maximum number of boards to return (default 25, max 100)
  • page number (nullable): Page number for pagination (default 1)

Returns:

  • boards array of objects: Array of boards
    • id string: Board ID
    • name string: Board name
    • state string: Board state (active, archived, deleted)
    • boardKind string: Board kind (public, private, share)
    • description string (nullable): Board description
    • workspaceId string (nullable): Workspace ID
    • itemsCount number: Number of items on the board

Example Usage:

{
  "state": "active",
  "boardKind": null,
  "workspaceIds": null,
  "limit": 25,
  "page": 1
}

Get Board

Get a specific board with its columns and groups.

Operation Type: Query (Read)

Parameters:

  • boardId string (required): The board ID to retrieve

Returns:

  • board object: The board details
    • id string: Board ID
    • name string: Board name
    • state string: Board state
    • boardKind string: Board kind
    • description string (nullable): Board description
    • workspaceId string (nullable): Workspace ID
    • itemsCount number: Number of items
    • columns array of objects: Board columns
      • id string: Column ID
      • title string: Column display title
      • type string: Column type (e.g., status, text, date)
      • description string (nullable): Column description
    • groups array of objects: Board groups
      • id string: Group ID
      • title string: Group display title
      • color string: Group color hex code

Example Usage:

{
  "boardId": "5092968103"
}

Items

Operations for managing items on Monday.com boards.

List Items

List items on a board with their column values. Supports cursor-based pagination.

Operation Type: Query (Read)

Parameters:

  • boardId string (required): The board ID to list items from
  • groupId string (nullable): Optional group ID to filter items
  • limit number (nullable): Maximum items to return (default 50, max 500)
  • cursor string (nullable): Pagination cursor from a previous response

Returns:

  • items array of objects: Array of items
    • id string: Item ID
    • name string: Item name
    • state string: Item state (active, archived, deleted)
    • groupId string: Group ID the item belongs to
    • groupTitle string: Group display title
    • createdAt string: ISO timestamp of creation
    • updatedAt string (nullable): ISO timestamp of last update
    • url string: Item URL
    • columnValues array of objects: Column values
      • id string: Column ID
      • title string: Column title
      • type string: Column type
      • text string (nullable): Human-readable text value
      • value string (nullable): Raw JSON value
  • cursor string (nullable): Cursor for next page, null if no more results

Example Usage:

{
  "boardId": "5092968103",
  "groupId": null,
  "limit": 50,
  "cursor": null
}

Get Item

Get a specific item by ID with all column values and subitems.

Operation Type: Query (Read)

Parameters:

  • itemId string (required): The item ID to retrieve

Returns:

  • item object: The item details
    • id string: Item ID
    • name string: Item name
    • state string: Item state
    • groupId string: Group ID
    • groupTitle string: Group title
    • boardId string: Board ID this item belongs to
    • createdAt string: ISO timestamp of creation
    • updatedAt string (nullable): ISO timestamp of last update
    • url string: Item URL
    • creatorId string: Creator's user ID
    • columnValues array of objects: Column values
      • id string: Column ID
      • title string: Column title
      • type string: Column type
      • text string (nullable): Human-readable text value
      • value string (nullable): Raw JSON value
    • subitems array of objects: Subitems
      • id string: Subitem ID
      • name string: Subitem name
      • state string: Subitem state

Example Usage:

{
  "itemId": "7654321098"
}

Create Item

Create a new item on a Monday.com board.

Operation Type: Mutation (Write)

Parameters:

  • boardId string (required): The board ID to create the item on
  • itemName string (required): Name for the new item
  • groupId string (nullable): Group ID to place the item in
  • columnValues string (nullable): JSON string of column values (e.g., {"status": {"label": "Working on it"}, "date": {"date": "2024-01-15"}})

Returns:

  • item object: The created item
    • id string: Item ID
    • name string: Item name
    • state string: Item state
    • createdAt string: ISO timestamp of creation
    • url string: Item URL

Example Usage:

{
  "boardId": "5092968103",
  "itemName": "Design review meeting",
  "groupId": "new_group",
  "columnValues": "{\"status\": {\"label\": \"Working on it\"}, \"date\": {\"date\": \"2024-03-15\"}}"
}

Update Item

Update column values on an existing item.

Operation Type: Mutation (Write)

Parameters:

  • boardId string (required): The board ID the item belongs to
  • itemId string (required): The item ID to update
  • columnValues string (required): JSON string of column values to update

Returns:

  • item object: The updated item
    • id string: Item ID
    • name string: Item name
    • state string: Item state
    • url string: Item URL

Example Usage:

{
  "boardId": "5092968103",
  "itemId": "7654321098",
  "columnValues": "{\"status\": {\"label\": \"Done\"}, \"date\": {\"date\": \"2024-03-20\"}}"
}

Move Item to Group

Move an item to a different group on the same board.

Operation Type: Mutation (Write)

Parameters:

  • itemId string (required): The item ID to move
  • groupId string (required): The target group ID

Returns:

  • item object: The moved item
    • id string: Item ID
    • name string: Item name
    • groupId string: New group ID
    • groupTitle string: New group title

Example Usage:

{
  "itemId": "7654321098",
  "groupId": "completed_group"
}

Common Use Cases

Project Management:

  • List all boards to get an overview of active projects
  • Create items for new tasks and assign them to groups
  • Move items between groups to reflect workflow stages (e.g., To Do → In Progress → Done)

Status Tracking:

  • Get board details with columns and groups to understand project structure
  • List items with column values to track task status, assignments, and deadlines
  • Update item column values to change status, dates, or other fields

Automation & Integration:

  • Create items automatically from external triggers (e.g., form submissions, emails)
  • Sync item status with other tools when column values change
  • Generate reports by listing items and aggregating column values

Team Coordination:

  • Get item details including subitems for detailed task breakdowns
  • Update items to reflect progress from other systems
  • Use cursor-based pagination to process large boards efficiently