Advanced Analytica Advanced Analytica: IBOM
← All connectors
Monday logo

Source connector

Monday

Set up Monday as a source and move its data into your chosen destination.

Version 2.6.3 certified generally available

Monday

Use this guide to set up the Monday source connector and find reference information.

This connector uses the Monday.com GraphQL API (version 2026-01).

Prerequisites

To set up the Monday source connector, you need one of these credentials:

  • A Personal API Token. Generate it from your Monday.com account under Profile picture (top right corner) > Developers > API token.
  • An OAuth 2.0 application. Find or create it under Profile picture (top right corner) > Developers > My Apps.

For more information, see Monday.com’s authentication documentation.

Set up the connector

  1. In Airbyte, go to Sources and click + New source.
  2. Search for and select Monday.
  3. Enter a name for the connector.
  4. Choose your authentication method and enter the required credentials.
  5. To limit the Boards, Items, and Activity logs streams, optionally enter one or more board IDs in Boards to sync. Leave it empty to sync records from every board in your account.
  6. Optionally, set Number of concurrent threads to control the number of parallel requests. The default is 4, and the allowed range is 2 to 50. However, the connector caps effective concurrency at 40. This is Monday.com’s concurrency limit for the lowest plan tier. Increase this value only if your Monday.com plan’s rate limits allow it. Higher values can cause rate limit errors on lower tiers.
  7. Click Set up source.

Connect with OAuth 2.0

  1. Select OAuth2.0 in Authorization Method.
  2. If your Monday.com account uses a custom subdomain, enter it in the Subdomain/Slug field. This is the first part of the URL before .monday.com. Leave this field empty if you use the default monday.com domain.
  3. Click Authenticate your Monday account.
  4. Complete the authentication flow with your Monday.com credentials. The Airbyte app must be installed on your Monday.com account before you can authorise it. If it isn’t installed, Monday.com asks an account admin to install it, then continues to the consent screen. If you aren’t an admin, ask one to install the app first. If an admin completes the authorisation, the source syncs with that admin’s permissions.

Airbyte stores the access token with a refresh token and refreshes the access token automatically. Sources authenticated with connector versions before 2.6.0 hold a legacy access token. On the first 2.6.0 run, the connector automatically migrates it to the new OAuth flow. You’ll need to re-authenticate only if the migration fails. Run the source once on 2.6.0 before October 1, 2026, when Monday.com stops accepting legacy tokens. See Upgrading to 2.6.0. Monday.com expires a refresh token if it hasn’t been used for 3 months (monday.com update). You must re-authenticate a source that hasn’t synced for that long.

The connector requests these OAuth scopes: me:read, boards:read, workspaces:read, users:read, account:read, updates:read, assets:read, tags:read, and teams:read.

Upgrade to 2.6.0

Monday.com is moving its OAuth flow to OAuth 2.1. It stops accepting legacy OAuth access tokens on October 1, 2026. See the monday.com announcement and the monday.com migration guide.

Version 2.6.0 authenticates through the new token endpoint (https://auth.monday.com/oauth_ms/oauth/token) with PKCE. Rotating refresh tokens keep the access token current. The connector configuration stores a refresh_token alongside the access_token. The connector refreshes the access token automatically and saves the newest refresh token after each refresh. This isn’t a breaking change. Existing configurations remain valid and migrate automatically on their first run.

Who is affected: only sources that use the OAuth2.0 authorisation method. Sources that use a Personal API Token require no action.

What happens on upgrade:

  1. Airbyte Cloud applies the upgrade automatically through a progressive rollout. On self-managed Airbyte, upgrade the connector to 2.6.0 before October 1, 2026.
  2. Run a connection test or sync on 2.6.0. The connector exchanges the existing legacy access token through Monday.com’s token migration endpoint. It receives a new access token and refresh token, then stores them in the source configuration. You don’t need to re-authenticate if this succeeds.
  3. If a run asks you to re-authenticate, open the source in Airbyte and click Authenticate your Monday account. If the Airbyte app isn’t installed on your Monday.com account, Monday.com asks an account admin to install it. This can happen if the app was removed. The consent screen appears after installation, so ask an account admin to install the app first. If the admin completes the authorisation, the source syncs with that admin’s permissions.

Automatic migration works only while the legacy access token remains valid. Run the source once on 2.6.0 before October 1, 2026. Monday.com describes the migration endpoint as temporary and rate limited. If it rejects the token, complete the manual re-authentication in step 3. Rejection can occur because the token expired or was revoked, the Airbyte app was removed, or migration was disabled. It can also occur when a personal API token is stored in the OAuth2.0 settings. Re-authenticating with a version before 2.6.0 uses the legacy flow. This fails once the Airbyte app switches to Monday.com’s new OAuth flow. Any token issued through the legacy flow stops working on October 1, 2026. From that date, OAuth2.0 sources with unmigrated legacy tokens stop syncing until you re-authenticate them.

Connect with API Token

  1. Generate an API token as described in Monday.com’s authentication documentation.
  2. Select API Token in Authorization Method.
  3. Enter your token in the Personal API Token field.

Supported sync modes

The Monday source connector supports these sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncYes
NamespacesNo

Supported streams

You can use these streams:

StreamSync modeAPI documentation
Activity logsFull Refresh, IncrementalActivity logs
BoardsFull Refresh, IncrementalBoards
ItemsFull Refresh, IncrementalItems
TagsFull RefreshTags
TeamsFull RefreshTeams
UpdatesFull RefreshUpdates
UsersFull RefreshUsers
WorkspacesFull RefreshWorkspaces

Stream notes

  • The Boards stream includes each board’s column definitions. In your destination, they appear as nested data, typically named boards.columns.

  • The Items stream includes each item’s column values. In your destination, they appear as nested data, typically named items.column_values. Each column value includes the id, text, type, and value fields. Some column types include extra fields through typed values:

    • Connect Boards (board_relation) and Dependency (dependency) columns include a linked_item_ids array with linked item IDs. Use these IDs to join the Items stream and find details about linked items. The value field returns null for these column types.
    • Mirror, Connect Boards, and Dependency columns include a display_value field with a human-readable text representation.
  • Incremental sync for the Items and Boards streams relies on the Activity logs stream. The connector extracts board and item IDs from activity log events. It uses these IDs to sync only changed records. Some changes may be missed if the interval between syncs exceeds your Monday.com plan activity log retention period.

  • The Items stream uses cursor-based pagination, and Monday.com pagination cursors expire after 60 minutes. A board may take longer to read because of rate limiting or its size. The API then returns a CursorExpiredError, and the connector restarts pagination for that stream. Pagination restarts from the beginning. As a result, syncing very large boards can take longer than expected.

If you’d like Airbyte to support more endpoints, create an issue.

Performance considerations

Monday.com enforces rate limits based on your plan. These include per-minute query limits and a query complexity budget. The connector automatically retries complexity budget errors and HTTP rate limit responses with backoff. It follows the retry-after header when present. If you see rate limit errors, reduce the Number of concurrent threads setting. Please create an issue if any rate limit issues aren’t retried successfully.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
2.6.32026-11-0684969Fix silent truncation at 25 records in the workspaces and updates streams by sending an explicit page size
2.6.22026-10-1387933Update dependencies
2.6.12026-09-2987243Update dependencies
2.6.02026-09-2485170Move OAuth to Monday’s OAuth 2.1 flow (PKCE, new token endpoint, rotating refresh tokens); migrate existing legacy OAuth tokens automatically on the first run; prompt the admin to install the Airbyte app during authorization
2.5.222026-09-2286707Update dependencies
2.5.212026-09-1586149Update dependencies
2.5.202026-09-0885557Update dependencies
2.5.192026-08-1884675Update dependencies
2.5.182026-08-1184004Update dependencies
2.5.172026-07-2883194Update to CDK 7.23.8 (fixes AirbyteCustomCodeNotPermittedError for bundled custom components) and remove the temporary Cloud version override
2.5.162026-07-281082Roll Cloud back to 2.5.14 — 2.5.15 is built on SDM 7.23.7, which breaks bundled custom components
2.5.152026-07-2883007Update dependencies
2.5.142026-07-2182493Update dependencies
2.5.132026-07-1481908Update dependencies
2.5.122026-06-3081167Update dependencies
2.5.112026-06-2380562Update dependencies
2.5.102026-06-1678817Update dependencies
2.5.92026-06-0979605Clean up cancelled RC; revert source to previous stable
2.5.9-rc.22026-05-2878489Reduce default concurrency to 4 and enable tier-aware HTTPAPIBudget rate limiting
2.5.9-rc.12026-05-2678442Add subscription_tier spec field and tier-aware HTTPAPIBudget for concurrency tuning (Path B)
2.5.82026-04-2877302Update dependencies
2.5.72026-04-2176675Update dependencies
2.5.62026-04-1376276Rename “concurrent workers” to “concurrent threads” in connector spec
2.5.52026-03-1774325Migrate to scopes object array format
2.5.42026-03-1074620Update dependencies
2.5.32026-03-0573658Add linked_item_ids to BoardRelationValue and DependencyValue column types to restore linked item data lost after API version 2025-04+
2.5.22026-02-2473582Update dependencies
2.5.12026-02-1372192Add user_id field to activity_logs stream
2.5.02026-02-1172832Upgrade to Monday.com API version 2026-01
2.4.212026-02-1073038Update dependencies
2.4.202026-02-0372577Update dependencies
2.4.192026-01-2071994Update dependencies
2.4.182026-01-1471513Update dependencies
2.4.172025-12-1870552Update dependencies
2.4.162025-12-0369718Add pagination reset handling for Monday CursorExpiredError
2.4.152025-11-2569883Update dependencies
2.4.142025-11-1869367Update dependencies
2.4.132025-10-2969048Update dependencies
2.4.122025-10-2268591Add suggestedStreams
2.4.112025-10-2168416Update dependencies
2.4.102025-10-1467840Update dependencies
2.4.92025-10-0767393Update dependencies
2.4.82025-10-0266938Surface HTTP 200 Error Messages
2.4.72025-09-3066336Update dependencies
2.4.62025-09-1065884Update dependencies
2.4.52025-08-2364705Update dependencies
2.4.42025-08-1164878Pass query in json body of request instead of query params.
2.4.32025-08-0264220Update dependencies
2.4.22025-07-2663835Update dependencies
2.4.12025-07-1963206Update dependencies
2.4.02025-07-0962886Promoting release candidate 2.4.0-rc.1 to a main version.
2.4.0-rc.12025-07-0262444Migrate connector to manifest-only
2.3.12025-05-3153828Update dependencies
2.3.02025-04-0256967Promoting release candidate 2.3.0-rc.1 to a main version.
2.3.0-rc.12025-03-1855225Update CDK to v6
2.2.02025-03-1452780Add optional config parameter to control which boards are fetched when syncing the Boards stream
2.1.132025-02-0152780Update dependencies
2.1.122025-01-2551833Update dependencies
2.1.112025-01-1410311Update API version to 2024-10
2.1.102025-01-1151147Update dependencies
2.1.92025-01-0850984Update the spec to support Jinja style variables for DeclarativeOAuthFlow
2.1.82024-12-2850624Update dependencies
2.1.72024-12-2143901Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
2.1.62024-12-1949943Pin CDK constraint to avoid breaking change in newer versions
2.1.52024-10-3148054Moved to DeclarativeOAuthFlow specification
2.1.42024-08-1744201Add boards name to the items stream
2.1.32024-06-0438958[autopull] Upgrade base image to v1.2.1
2.1.22024-04-3037722Fetch display_value field for column values of Mirror, Dependency and Connect Board types
2.1.12024-04-0536717Add handling of complexityBudgetExhausted error.
2.1.02024-04-0336746Pin airbyte-cdk version to ^0
2.0.42024-02-2835696Fix extraction for null value in stream Activity logs
2.0.32024-02-2135506Support for column values of the mirror type for the Items stream.
2.0.22024-02-1235146Manage dependencies with Poetry.
2.0.12024-02-0835016Migrated to the latest airbyte cdk
2.0.02024-01-1234108Migrated to the latest API version: 2024-01
1.1.42023-12-1333448Increase test coverage and migrate to base image
1.1.32023-09-2330248Add new field “type” to board stream
1.1.22023-08-2329777Add retry for 502 error
1.1.12023-08-1529429Ignore null records in response
1.1.02023-07-0527944Add incremental sync for Items and Boards streams
1.0.02023-06-2027410Add new streams: Tags, Workspaces. Add new fields for existing streams.
0.2.62023-06-1227244Added http error handling for 403 and 500 HTTP errors
0.2.52023-05-2225881Fix pagination for the items stream
0.2.42023-04-2625277Increase row limit to 100
0.2.32023-03-0623231Publish using low-code CDK Beta version
0.2.22023-01-0420996Fix json schema loader
0.2.12022-12-1520533Bump CDK version
0.2.02022-12-1319586Migrate to low-code
0.1.42022-06-0614443Increase retry_factor for Items stream
0.1.32021-12-238172Add oauth2.0 support
0.1.22021-12-078429Update titles and descriptions
0.1.12021-11-188016🐛 Source Monday: fix pagination and schema bug
0.1.02021-11-077168🎉 New Source: Monday
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.