Access the Monday.com API with managed OAuth authentication. Manage boards, items, columns, groups, users, and workspaces using GraphQL.
Monday.com uses a GraphQL API. All operations are sent as POST requests with a JSON body containing the query field.
Reference
Current User (me)
POST /monday/v2
Content-Type: application/json
{"query": "{ me { id name email } }"}Response:
{
"data": {
"me": {
"id": "72989582",
"name": "Chris",
"email": "chris.kim.2332@gmail.com"
}
}
}Users
POST /monday/v2
Content-Type: application/json
{"query": "{ users(limit: 20) { id name email } }"}Workspaces
POST /monday/v2
Content-Type: application/json
{"query": "{ workspaces(limit: 10) { id name kind } }"}Response:
{
"data": {
"workspaces": [
{ "id": "10136488", "name": "Main workspace", "kind": "open" }
]
}
}List Boards
POST /monday/v2
Content-Type: application/json
{"query": "{ boards(limit: 10) { id name state board_kind workspace { id name } } }"}Response:
{
"data": {
"boards": [
{
"id": "8614733398",
"name": "Welcome to your developer account",
"state": "active",
"board_kind": "public",
"workspace": { "id": "10136488", "name": "Main workspace" }
}
]
}
}Get Board with Columns, Groups, and Items
POST /monday/v2
Content-Type: application/json
{"query": "{ boards(ids: [BOARD_ID]) { id name columns { id title type } groups { id title } items_page(limit: 20) { cursor items { id name state } } } }"}Create Board
POST /monday/v2
Content-Type: application/json
{"query": "mutation { create_board(board_name: \"New Board\", board_kind: public) { id name } }"}Response:
{
"data": {
"create_board": {
"id": "18398921201",
"name": "New Board"
}
}
}Update Board
POST /monday/v2
Content-Type: application/json
{"query": "mutation { update_board(board_id: BOARD_ID, board_attribute: description, new_value: \"Board description\") }"}Delete Board
POST /monday/v2
Content-Type: application/json
{"query": "mutation { delete_board(board_id: BOARD_ID) { id } }"}Get Items by ID
POST /monday/v2
Content-Type: application/json
{"query": "{ items(ids: [ITEM_ID]) { id name created_at updated_at state board { id name } group { id title } column_values { id text value } } }"}Response:
{
"data": {
"items": [
{
"id": "11200791874",
"name": "Test item",
"created_at": "2026-02-05T20:12:42Z",
"updated_at": "2026-02-05T20:12:42Z",
"state": "active",
"board": { "id": "8614733398", "name": "Welcome to your developer account" },
"group": { "id": "topics", "title": "Group Title" }
}
]
}
}Create Item
POST /monday/v2
Content-Type: application/json
{"query": "mutation { create_item(board_id: BOARD_ID, group_id: \"GROUP_ID\", item_name: \"New item\") { id name } }"}Create Item with Column Values
POST /monday/v2
Content-Type: application/json
{"query": "mutation { create_item(board_id: BOARD_ID, group_id: \"GROUP_ID\", item_name: \"New task\", column_values: \"{\\\"status\\\": {\\\"label\\\": \\\"Working on it\\\"}}\") { id name column_values { id text } } }"}Update Item Name
POST /monday/v2
Content-Type: application/json
{"query": "mutation { change_simple_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: \"name\", value: \"Updated name\") { id name } }"}Update Column Value
POST /monday/v2
Content-Type: application/json
{"query": "mutation { change_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: \"status\", value: \"{\\\"label\\\": \\\"Done\\\"}\") { id name } }"}Delete Item
POST /monday/v2
Content-Type: application/json
{"query": "mutation { delete_item(item_id: ITEM_ID) { id } }"}Create Column
POST /monday/v2
Content-Type: application/json
{"query": "mutation { create_column(board_id: BOARD_ID, title: \"Status\", column_type: status) { id title type } }"}Response:
{
"data": {
"create_column": {
"id": "color_mm09e48w",
"title": "Status",
"type": "status"
}
}
}Column Types
Common column types: status, text, numbers, date, people, dropdown, checkbox, email, phone, link, timeline, tags, rating
Create Group
POST /monday/v2
Content-Type: application/json
{"query": "mutation { create_group(board_id: BOARD_ID, group_name: \"New Group\") { id title } }"}Response:
{
"data": {
"create_group": {
"id": "group_mm0939df",
"title": "New Group"
}
}
}