monday.com

Monday.com is a work operating system that powers teams to run projects and workflows with confidence.

Type: monday/v1

Connections

Version: 1

OAuth2 Authorization Code

Properties

Name	Label	Type	Description	Required
clientId	Client Id	STRING		true
clientSecret	Client Secret	STRING		true

Connection Setup

Connect monday.com to ByteChef using OAuth 2.0 (Authorization Code).

Create an OAuth app in monday.com

Open monday.com and click your profile avatar (top-right).
Click on Developers to open the Developer Center.
Click Create app (or open your existing app).
Give the app a clear name, for example ByteChef Integration.
In the left menu, open Build and choose OAuth & permissions.
Add the following scopes (minimum required by ByteChef):
- boards:read
- boards:write
- workspaces:read
- webhooks:write
Save the scopes.
Click on Redirect URLs and add the ByteChef OAuth redirect (callback) URL(s):
- Cloud: https://app.bytechef.io/callback
- Local development: http://127.0.0.1:5173/callback or http://localhost:5173/callback
Go back to General settings and copy your Client ID and Client Secret for later.

Actions

Create Board

Name: createBoard

Create a new board.

Properties

Name	Label	Type	Description	Required
board_name	Board Name	STRING	Name of the new board.	true
board_kind	Board Kind	STRING Options private, public, share	The type of board to create.	true
description	Description	STRING	Detailed description of the new board.	false

Example JSON Structure

{
  "label" : "Create Board",
  "name" : "createBoard",
  "parameters" : {
    "board_name" : "",
    "board_kind" : "",
    "description" : ""
  },
  "type" : "monday/v1/createBoard"
}

Output

Type: OBJECT

Properties

Name	Type	Description
create_board	OBJECT Properties {STRING(id), STRING(board_name)}

Output Example

{
  "create_board" : {
    "id" : "",
    "board_name" : ""
  }
}

Create Column

Name: createColumn

Create a new column in board.

Properties

Name	Label	Type	Description	Required
workspace_id	Workspace ID	STRING		false
board_id	Board ID	STRING Depends On workspace_id	Id of the board where the new column should be created.	true
title	Title	STRING	The new column's title.	true
column_type	Column Type	STRING Options auto_number, board_relation, button, checkbox, color_picker, country, creation_log, date, dependency, doc, dropdown, email, file, formula, hour, item_assignees, item_id, last_updated, link, location, long_text, mirror, name, numbers, people, phone, progress, rating, status, subtasks, tags, team, text, timeline, time_tracking, vote, week, world_clock, unsupported	The type of column to create.	true

Example JSON Structure

{
  "label" : "Create Column",
  "name" : "createColumn",
  "parameters" : {
    "workspace_id" : "",
    "board_id" : "",
    "title" : "",
    "column_type" : ""
  },
  "type" : "monday/v1/createColumn"
}

Output

Type: OBJECT

Properties

Name	Type	Description
create_column	OBJECT Properties {STRING(id), STRING(title)}

Output Example

{
  "create_column" : {
    "id" : "",
    "title" : ""
  }
}

Create Group

Name: createGroup

Creates a new group in board.

Properties

Name	Label	Type	Description	Required
workspace_id	Workspace ID	STRING		false
board_id	Board ID	STRING Depends On workspace_id	Id of the board where new item will be created.	true
group_name	Group Name	STRING		true

Example JSON Structure

{
  "label" : "Create Group",
  "name" : "createGroup",
  "parameters" : {
    "workspace_id" : "",
    "board_id" : "",
    "group_name" : ""
  },
  "type" : "monday/v1/createGroup"
}

Output

Type: OBJECT

Properties

Name	Type	Description
create_group	OBJECT Properties {STRING(id), STRING(name)}

Output Example

{
  "create_group" : {
    "id" : "",
    "name" : ""
  }
}

Create Item

Name: createItem

Create a new item in a board.

Properties

Name	Label	Type	Description	Required
workspace_id	Workspace ID	STRING		false
board_id	Board ID	STRING Depends On workspace_id	ID of the board where new item will be created.	true
group_id	Group ID	STRING Depends On workspace_id, board_id	The item's group.	false
item_name	Item Name	STRING	The item's name.	true
columnValues		DYNAMIC_PROPERTIES Depends On workspace_id, board_id, group_id		false

Example JSON Structure

{
  "label" : "Create Item",
  "name" : "createItem",
  "parameters" : {
    "workspace_id" : "",
    "board_id" : "",
    "group_id" : "",
    "item_name" : "",
    "columnValues" : { }
  },
  "type" : "monday/v1/createItem"
}

Output

Type: OBJECT

Properties

Name	Type	Description
create_item	OBJECT Properties {STRING(id), STRING(name)}

Output Example

{
  "create_item" : {
    "id" : "",
    "name" : ""
  }
}

Delete Item

Name: deleteItem

Deletes an item from a board.

Properties

Name	Label	Type	Description	Required
workspace_id	Workspace ID	STRING		false
board_id	Board ID	STRING Depends On workspace_id	ID of the board where the item is located.	false
item_id	Item ID	STRING Depends On board_id, workspace_id	ID of the item to delete.	true

Example JSON Structure

{
  "label" : "Delete Item",
  "name" : "deleteItem",
  "parameters" : {
    "workspace_id" : "",
    "board_id" : "",
    "item_id" : ""
  },
  "type" : "monday/v1/deleteItem"
}

Output

This action does not produce any output.

Triggers

New Item in Board

Name: newItemInBoard

Triggers when an item is created in board.

Type: DYNAMIC_WEBHOOK

Properties

Name	Label	Type	Description	Required
workspace_id	Workspace ID	STRING		false
board_id	Board ID	STRING Depends On workspace_id		true

Output

The output for this action is dynamic and may vary depending on the input parameters. To determine the exact structure of the output, you need to execute the action.

JSON Example

{
  "label" : "New Item in Board",
  "name" : "newItemInBoard",
  "parameters" : {
    "workspace_id" : "",
    "board_id" : ""
  },
  "type" : "monday/v1/newItemInBoard"
}

On this page