Monday.com

Connect & Ingest data from Monday.com

Monday.com is a work operating system (Work OS) for project management, task tracking, and team collaboration. The Sling Monday.com connector extracts data from Monday.com's GraphQL API, supporting users, teams, tags, workspaces, boards (with columns and groups), items (tasks/rows), updates (comments), and activity logs.

CLI Pro Required: APIs require a CLI Pro token or Platform Plan.

Setup

The following credentials and inputs are accepted:

Secrets:

• api_key (required) -> Your Monday.com Personal API Token

Inputs (optional):

• anchor_date -> Starting date for first sync of incremental endpoints (ISO 8601 format, e.g., 2024-01-01T00:00:00Z). Defaults to 1 year ago.

Getting Your API Token

1. Log in to Monday.com

2. Click your avatar (bottom-left corner)

3. Go to Developers

4. Navigate to My access tokens in the Developer Center

5. Copy your Personal API Token

Important: Personal API tokens grant the same access as your user account. Use a dedicated service account with appropriate permissions for production workloads.

Using sling conns

sling conns set MONDAY type=api spec=monday secrets='{ api_key: your_api_token_here }'

Environment Variable

See here to learn more about the .env.sling file.

export MONDAY='{ type: api, spec: monday, secrets: { api_key: "your_api_token_here" } }'

Sling Env File YAML

See here to learn more about the sling env.yaml file.

connections:
  MONDAY:
    type: api
    spec: monday
    secrets:
      api_key: "your_api_token_here"

Replication

Here's an example replication configuration to sync Monday.com data to a PostgreSQL database:

source: MONDAY
target: MY_POSTGRES

defaults:
  mode: full-refresh
  object: monday.{stream_name}

streams:
  # sync all endpoints
  '*':

Incremental sync for updates and activity logs:

source: MONDAY
target: MY_POSTGRES

defaults:
  object: monday.{stream_name}

streams:
  users:
    mode: full-refresh

  teams:
    mode: full-refresh

  tags:
    mode: full-refresh

  workspaces:
    mode: full-refresh

  boards:
    mode: full-refresh

  items:
    mode: full-refresh

  updates:
    mode: incremental
    primary_key: [id]
    update_key: updated_at

  activity_logs:
    mode: incremental
    primary_key: [id]
    update_key: created_at

Endpoints

Endpoint	Description	Incremental
users	All users in the account with profile details	No
teams	All teams with owners and members	No
tags	All tags used across boards	No
workspaces	All workspaces	No
boards	All boards with columns, groups, owners, subscribers, and tags	No
items	All items (tasks/rows) from all boards with column values and subitems	No
updates	All updates (comments/activity) with replies and attachments	Yes
activity_logs	Activity logs from all boards	Yes

To discover available endpoints:

sling conns discover MONDAY

Incremental Sync

Two endpoints support incremental sync:

updates — Fetches updates modified since the last sync:

• First run: Fetches all updates from the last year (or since anchor_date if provided)

• Subsequent runs: Only fetches updates modified after the last sync timestamp

activity_logs — Fetches activity logs created since the last sync:

• First run: Fetches all activity logs from the last year (or since anchor_date)

• Subsequent runs: Only fetches new activity logs

All other endpoints run in full-refresh mode. Items, boards, and other entities are relatively fast to sync via full-refresh since Monday.com's GraphQL API returns them efficiently.

How It Works

The Monday.com connector uses Monday.com's GraphQL API (API version 2025-01). A few implementation details:

• Boards populate a queue — The boards endpoint collects all board IDs into a queue. The items and activity_logs endpoints then iterate over this queue to fetch data per-board.

• Items use cursor-based pagination — Items are fetched using Monday.com's items_page with cursor-based pagination for efficient retrieval of large boards.

• All other endpoints use page-based pagination — Users, workspaces, updates, and activity logs paginate by page number.

Rate Limiting

The Monday.com API enforces rate limits based on your plan:

• Free plan: 200 API calls per day

• Pro/Enterprise: Higher limits (1,000–25,000+ calls per day)

The connector automatically:

• Uses conservative rate limiting (1 request/second)

• Retries with exponential backoff on 429 (rate limit) responses, up to 5 attempts

Tip: For accounts with many boards and items, a paid plan is recommended to avoid hitting the free plan's daily API call limit during sync.

If you are facing issues connecting, please reach out to us at [email protected], on discord or open a Github Issue here.