Monday.com - Spojit

The Monday.com connector lets your workflows manage boards, items, updates, and workspaces through the Monday.com GraphQL API.

For the full API reference, see the Monday.com API documentation.

Connection setup

Get your API token

In Monday.com, click your avatar in the bottom-left corner and go to Developers > My Access Tokens. Copy your personal API token (or create a new one for your integration).

Add the connection in Spojit

Go to Connections in Spojit, click Add Connection, select Monday.com, and enter:

API Token: Your Monday.com API token

Monday.com uses a GraphQL API. All tools translate to GraphQL queries and mutations under the hood.

Tools

Boards

list-boards — List boards

limit

number

default:"25"

Number of boards to return.

page

number

default:"1"

Page number for pagination.

workspace_id

number

Filter by workspace ID.

board_kind

string

Filter by board type: public, private, or share.

Example request:

{
  "limit": 3
}

Example response:

{
  "data": {
    "boards": [
      {
        "id": "1234567890",
        "name": "Project Tracker",
        "state": "active",
        "board_kind": "public",
        "columns": [
          { "id": "status", "title": "Status", "type": "status" },
          { "id": "person", "title": "Owner", "type": "people" },
          { "id": "date4", "title": "Due Date", "type": "date" }
        ],
        "groups": [
          { "id": "new_group", "title": "To Do" },
          { "id": "group_2", "title": "In Progress" },
          { "id": "group_3", "title": "Done" }
        ]
      },
      {
        "id": "1234567891",
        "name": "Bug Reports",
        "state": "active",
        "board_kind": "public",
        "columns": [
          { "id": "status", "title": "Priority", "type": "status" },
          { "id": "text0", "title": "Description", "type": "text" }
        ],
        "groups": [
          { "id": "new_group", "title": "Open" },
          { "id": "group_2", "title": "Closed" }
        ]
      }
    ]
  }
}

get-board — Get a board by ID

Returns board details including columns and groups.

number

required

Board ID.

Example request:

{
  "id": 1234567890
}

Example response:

{
  "data": {
    "boards": [
      {
        "id": "1234567890",
        "name": "Project Tracker",
        "state": "active",
        "columns": [
          { "id": "status", "title": "Status", "type": "status" },
          { "id": "person", "title": "Owner", "type": "people" },
          { "id": "date4", "title": "Due Date", "type": "date" },
          { "id": "numbers", "title": "Story Points", "type": "numbers" }
        ],
        "groups": [
          { "id": "new_group", "title": "To Do" },
          { "id": "group_2", "title": "In Progress" },
          { "id": "group_3", "title": "Done" }
        ],
        "items_page": {
          "cursor": "MSw1LGl0ZW1faWQ...",
          "items": [
            {
              "id": "9876543210",
              "name": "Design new landing page",
              "column_values": [
                { "id": "status", "text": "Working on it", "value": "{\"index\":1}" },
                { "id": "date4", "text": "2024-07-15", "value": "{\"date\":\"2024-07-15\"}" }
              ]
            }
          ]
        }
      }
    ]
  }
}

Items

list-items — List items on a board

board_id

number

required

Board ID to list items from.

limit

number

default:"25"

Number of items to return.

page

number

default:"1"

Page number for pagination.

group_id

string

Filter by group ID within the board.

Example request:

{
  "board_id": 1234567890,
  "limit": 2
}

Example response:

{
  "data": {
    "boards": [
      {
        "items_page": {
          "cursor": "MSw1LGl0ZW1faWQ...",
          "items": [
            {
              "id": "9876543210",
              "name": "Design new landing page",
              "column_values": [
                { "id": "status", "text": "Working on it", "value": "{\"index\":1}" },
                { "id": "person", "text": "Alice", "value": "{\"personsAndTeams\":[{\"id\":12345}]}" },
                { "id": "date4", "text": "2024-07-15", "value": "{\"date\":\"2024-07-15\"}" }
              ],
              "group": { "id": "group_2", "title": "In Progress" }
            },
            {
              "id": "9876543211",
              "name": "Write API documentation",
              "column_values": [
                { "id": "status", "text": "Done", "value": "{\"index\":2}" },
                { "id": "person", "text": "Bob", "value": "{\"personsAndTeams\":[{\"id\":12346}]}" },
                { "id": "date4", "text": "2024-07-10", "value": "{\"date\":\"2024-07-10\"}" }
              ],
              "group": { "id": "group_3", "title": "Done" }
            }
          ]
        }
      }
    ]
  }
}

get-item — Get an item by ID

Returns item details including column values.

number

required

Item ID.

Example request:

{
  "id": 9876543210
}

Example response:

{
  "data": {
    "items": [
      {
        "id": "9876543210",
        "name": "Design new landing page",
        "board": { "id": "1234567890", "name": "Project Tracker" },
        "column_values": [
          { "id": "status", "title": "Status", "text": "Working on it", "value": "{\"index\":1}", "type": "status" },
          { "id": "person", "title": "Owner", "text": "Alice", "value": "{\"personsAndTeams\":[{\"id\":12345}]}", "type": "people" },
          { "id": "date4", "title": "Due Date", "text": "2024-07-15", "value": "{\"date\":\"2024-07-15\"}", "type": "date" },
          { "id": "numbers", "title": "Story Points", "text": "5", "value": "\"5\"", "type": "numbers" }
        ],
        "updates": [
          {
            "id": "111222333",
            "text_body": "Mockups are ready for review",
            "created_at": "2024-07-08T10:30:00Z",
            "creator": { "id": "12345", "name": "Alice Johnson" }
          }
        ]
      }
    ]
  }
}

create-item — Create a new item

board_id

number

required

Board ID to create the item in.

item_name

string

required

Item name.

group_id

string

Group ID within the board. Uses the first group if not specified.

column_values

object

Column values as a JSON object. Keys are column IDs, values follow Monday.com column value format.

Example request:

{
  "board_id": 1234567890,
  "item_name": "Fix login button on mobile",
  "group_id": "new_group",
  "column_values": {
    "status": { "label": "Working on it" },
    "person": { "personsAndTeams": [{ "id": 12345, "kind": "person" }] },
    "date4": { "date": "2024-07-20" }
  }
}

Example response:

{
  "data": {
    "create_item": {
      "id": "9876543212",
      "name": "Fix login button on mobile"
    }
  }
}

update-item — Update an item's column values

board_id

number

required

Board ID the item belongs to.

number

required

Item ID.

column_values

object

required

Column values to update. Keys are column IDs.

Example request:

{
  "board_id": 1234567890,
  "id": 9876543210,
  "column_values": {
    "status": { "label": "Done" },
    "numbers": "8"
  }
}

Example response:

{
  "data": {
    "change_multiple_column_values": {
      "id": "9876543210",
      "name": "Design new landing page"
    }
  }
}

delete-item — Delete an item

number

required

Item ID.

Example request:

{
  "id": 9876543212
}

Example response:

{
  "data": {
    "delete_item": {
      "id": "9876543212"
    }
  }
}

Updates

create-update — Post an update on an item

item_id

number

required

Item ID to post the update on.

body

string

required

Update body text (HTML supported).

Example request:

{
  "item_id": 9876543210,
  "body": "Completed the design review. Moving to development next week."
}

Example response:

{
  "data": {
    "create_update": {
      "id": "111222334",
      "text_body": "Completed the design review. Moving to development next week."
    }
  }
}

Workspaces

list-workspaces — List workspaces

limit

number

default:"25"

Number of workspaces to return.

page

number

default:"1"

Page number for pagination.

Example response:

{
  "data": {
    "workspaces": [
      {
        "id": "444555",
        "name": "Engineering",
        "kind": "open",
        "description": "Engineering team workspace"
      },
      {
        "id": "444556",
        "name": "Marketing",
        "kind": "open",
        "description": "Marketing campaigns and content"
      }
    ]
  }
}

Advanced

raw-graphql — Execute arbitrary GraphQL

Run any GraphQL query or mutation against the Monday.com API.

query

string

required

GraphQL query or mutation string.

variables

object

GraphQL variables.

Example request:

{
  "query": "query { users { id name email } }"
}

Example response:

{
  "data": {
    "users": [
      {
        "id": "12345",
        "name": "Alice Johnson",
        "email": "alice@example.com"
      },
      {
        "id": "12346",
        "name": "Bob Williams",
        "email": "bob@example.com"
      }
    ]
  }
}

Documentation Index

​Connection setup

​Tools

​Boards

​Items

​Updates

​Workspaces

​Advanced

Connection setup

Tools

Boards

Items

Updates

Workspaces

Advanced