> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreflux.org/llms.txt
> Use this file to discover all available pages before exploring further.

# monday.com

> Client-mode REST API connector for monday.com GraphQL API v2: me smoke, create_item, change_multiple_column_values, items_page query, and create_webhook

Technical Preview

## Overview

A client-mode connector for a **curated work-management** slice of the [monday.com GraphQL API](https://developer.monday.com/api-reference/docs/getting-started) (single `POST /v2` endpoint):

| Catalog connector event | Entity / path | Notes |
| - | - | - |
| POST create\_item | `POST /v2` mutation `create_item` | Create board item from alarm / MQTT |
| POST change\_multiple\_column\_values | `POST /v2` mutation | Update column values (JSON string) |
| POST items\_page | `POST /v2` query `boards { items_page }` | Page / list board items |
| me (smoke) | `POST /v2` query `me` | Credential check → `data.me.id` |
| POST create\_webhook | `POST /v2` mutation `create_webhook` | Register monday → HTTPS target |

Default `BASE_ADDRESS` is `https://api.monday.com`. Topics use `devops/monday-com/<object>/<verb>`.

> [!NOTE]
>
> Auth is the **raw personal API V2 token** in `Authorization` (**no** `Bearer ` prefix). Prefer Hub secret `MONDAY_API_TOKEN` (aliases `MONDAY_ACCESS_TOKEN`, `MONDAY_TOKEN`). Status remains blocked until an authenticated live smoke succeeds.

## Basic Syntax

```lot wrap theme={"theme":"css-variables","languages":{"custom":["/languages/lot.json"]}}
# Coreflux REST_API template — monday.com GraphQL API v2
# Auth: Authorization {value.json.access_token} (raw token, no Bearer)
# BASE_ADDRESS: https://api.monday.com

DEFINE ROUTE MondayComRestApi WITH TYPE REST_API
    ADD REST_API_CONFIG
        WITH BASE_ADDRESS "https://api.monday.com"
        WITH ENABLE_CLIENT "true"
        WITH USE_SSL "true"
        WITH REQUEST_TIMEOUT '60'
        WITH DEFAULT_CONTENT_TYPE "application/json"
    ADD EVENT Me
        WITH SOURCE_TOPIC "devops/monday-com/me/get"
        WITH DESTINATION_TOPIC "devops/monday-com/me/get/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/v2"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "{value.json.access_token}"
            ADD "API-Version" "2024-10"
        WITH BODY "{payload}"
    ADD EVENT Createitem
        WITH SOURCE_TOPIC "devops/monday-com/item/create"
        WITH DESTINATION_TOPIC "devops/monday-com/item/create/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/v2"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "{value.json.access_token}"
            ADD "API-Version" "2024-10"
        WITH BODY "{payload}"
    ADD EVENT Changemultiplecolumnvalues
        WITH SOURCE_TOPIC "devops/monday-com/item/columns"
        WITH DESTINATION_TOPIC "devops/monday-com/item/columns/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/v2"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "{value.json.access_token}"
            ADD "API-Version" "2024-10"
        WITH BODY "{payload}"
    ADD EVENT Itemspage
        WITH SOURCE_TOPIC "devops/monday-com/item/page"
        WITH DESTINATION_TOPIC "devops/monday-com/item/page/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/v2"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "{value.json.access_token}"
            ADD "API-Version" "2024-10"
        WITH BODY "{payload}"
    ADD EVENT Createwebhook
        WITH SOURCE_TOPIC "devops/monday-com/webhook/create"
        WITH DESTINATION_TOPIC "devops/monday-com/webhook/create/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/v2"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "{value.json.access_token}"
            ADD "API-Version" "2024-10"
        WITH BODY "{payload}"
```

## Events

| Event | Method | Endpoint | Request topic | Response topic |
| - | - | - | - | - |
| Me | POST | `/v2` | `devops/monday-com/me/get` | `devops/monday-com/me/get/response` |
| Createitem | POST | `/v2` | `devops/monday-com/item/create` | `devops/monday-com/item/create/response` |
| Changemultiplecolumnvalues | POST | `/v2` | `devops/monday-com/item/columns` | `devops/monday-com/item/columns/response` |
| Itemspage | POST | `/v2` | `devops/monday-com/item/page` | `devops/monday-com/item/page/response` |
| Createwebhook | POST | `/v2` | `devops/monday-com/webhook/create` | `devops/monday-com/webhook/create/response` |

## Authentication

Personal API V2 tokens from monday Developer Center → **API token**. Pass as `Authorization: <token>` with **no** `Bearer ` prefix. Prefer Hub / `GET SECRET "MONDAY_API_TOKEN"`.

Optional `API-Version` header pins the monday API version (template uses `2024-10`).

## Live test

Blocked until `MONDAY_API_TOKEN` (or alias) is available. Prefer:

```bash theme={"theme":"css-variables","languages":{"custom":["/languages/lot.json"]}}
curl -sS -X POST https://api.monday.com/v2 \
  -H "Authorization: $MONDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "API-Version: 2024-10" \
  -d '{"query":"query { me { id name email } }"}'
```

Expect **HTTP 200** and `data.me.id`.

## Related

* [REST API Connectors](/latest/lot-language/routes/rest-api-routes)
* [Asana](/latest/lot-language/routes/rest-api-apps/asana)
* [monday.com API — Getting started](https://developer.monday.com/api-reference/docs/getting-started)
* [Authentication](https://developer.monday.com/api-reference/docs/authentication)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.