monday.com connector: Support board-level updates in Updates stream

[rajathsinhaa]

Description

The monday.com connector currently extracts item-level updates only from the updates stream. Board-level updates (updates posted directly on boards, not tied to specific items) are not retrieved, even though monday.com’s API supports them via a nested GraphQL query.

This limitation prevents users from capturing a complete history of activity and discussions at the board level.

---

Observations

❌ Data Absence
Board-level updates are not replicated to the destination. Only item-level updates appear in the updates stream.

✅ Schema Visibility
The boards stream is available but only contains board metadata (name, owner, settings). It does not include updates.

🔍 API Capability
monday.com’s API supports board-level updates via a nested GraphQL query:

boards {
  updates {
    id
    body
    created_at
    creator
  }
}

However, the connector currently uses the root updates query, which returns item-level updates only.

---

Relevant Information

monday.com API documentation confirms support for board-level updates:
👉 https://developer.monday.com/api-reference/reference/updates

---

Proposed Actions

• Enhance Connector: Extend the monday.com connector to fetch board-level updates using the boards { updates { ... } } GraphQL query.

• Stream Design: Either:

  • Add board-level updates to the existing updates stream, or
  • Introduce a separate stream (e.g., board_updates) for clarity.

• Pagination & Rate Limits: Ensure the implementation handles pagination and monday.com API rate limits appropriately.

---

Example Fields to Extract

Dimensions

• board_id
• update_id
• created_at
• creator_id

Fields

• body
• update_type (board vs item, if applicable)
• creator_name

---

Impact

Adding board-level updates support will:

• Provide full visibility into monday.com activity, including board announcements and discussions
• Reduce confusion where users expect board updates to appear but see only item updates
• Align the connector’s behavior more closely with monday.com’s API capabilities

---

Additional Information

Customer expected board-level updates to be present in the destination because:

• The boards stream is enabled
• monday.com documentation indicates board updates should be returned by the API

Current behavior is working as implemented, but missing functionality leads to incomplete data ingestion.

---

Impacted Customers

Affected User	Prospect or Customer?	Account / Workspace	Supporting Link
The Information Lab	Customer	Workspace	Zendesk Ticket