Monday.com

Monday.com is a work management platform for project tracking and collaboration.

Overview

Monday.com is a work-OS built around boards, groups, items, and column types. Teams use it for project tracking, CRM, recruiting, marketing calendars, and any structured workflow that needs visual status. Every account exposes a GraphQL API that mirrors the board structure.

In Spojit, Monday.com is most often used as a board-shaped destination for operational data: orders create items on a fulfillment board, support emails become tasks, scheduled shifts mirror as items for visibility. The connector also reads boards back so AI steps can summarise status, detect stalled items, or fan updates to Slack.

What You Can Do

The Monday.com connector exposes these tools:

create-item - create a new item on a board, optionally in a specific group with column values.
create-update - post an update (comment) on an item.
delete-item - delete an item by id.
get-board - fetch a board's columns, groups, and metadata.
get-item - fetch a single item with its column values.
list-boards - list boards in the account.
list-items - list items on a board with pagination.
list-workspaces - list workspaces in the account.
raw-graphql - run any Monday GraphQL query or mutation directly.
update-item - update column values on an existing item.

Authentication

Monday.com uses an API token. Generate one from your Monday profile at Profile menu -> Developers -> My access tokens. The token inherits the permissions of the user who created it, so create it from an account that can read every board you need and write to boards you intend to update. Tokens are long-lived and can be revoked from the same page.

Setting Up Your Connection

In Monday.com, open Profile menu -> Developers -> My access tokens and copy your personal API token.
In Spojit, go to Connections from the sidebar.
Click + Add Connection and search for Monday.com.
Paste the API token, name the connection (for example, Monday - Operations) and click Save.
Run a quick list-workspaces call in a test workflow to confirm the token has the expected access.

Using in a Workflow

Use Direct Mode for predictable item creation and updates where you know the board id and column structure. Use Agent Mode when an AI step needs to inspect a board, decide which group an item belongs in, and pick the right column values. For complex queries (joining boards, filtering by column value), prefer raw-graphql over list-items with client-side filtering.

Tips

Monday's API uses complexity-based rate limiting; raw-graphql with broad queries can exhaust the budget faster than narrow tool calls.
Column values for create-item and update-item must be passed as a JSON string keyed by column id, not column name.
Cache the output of get-board at workflow start to map column titles to ids for downstream steps.
The raw-graphql tool gives you access to file uploads, mirror columns, and subitems that the dedicated tools do not cover.
Item names are not unique; track items by id once created.

Common Pitfalls

Column ids look like short strings (status, date4); titles are what humans see in the UI. Mixing them up is the most common failure mode.
Status columns require the label index or label name in the JSON, not arbitrary text.
API tokens are user-scoped; the user must be invited to a board for the token to access it.
Date columns expect ISO date strings; datetime values need both date and time keys in the JSON.
Deleting an item is not reversible from the API; the recycle bin only retains items deleted via the UI.

Common Use Cases

For technical API details and field specifications, see the Monday.com connector documentation.