Skip to main content

Monday

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Connector type (beta)
Available Data replicationAvailable Agent(learn more)
Support Level
Airbyte
Connector Version
2.6.1 (last updated 10 days ago)
Sync Success Rate
High
Usage Rate
High
Data workers used
0.2 per sync (Learn more)
Definition ID
80a54ea2-9959-4040-aac1-eee42423ec9b

This page contains the setup guide and reference information for the Monday source connector.

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

Prerequisites​

To set up the Monday source connector, you need either:

  • A Personal API Token, which you can generate from your Monday.com account under Profile picture (top right corner) > Developers > API token.
  • An OAuth 2.0 application, which you can find or create under Profile picture (top right corner) > Developers > My Apps.

For more details, see Monday.com's authentication documentation.

Setup guide​

  1. In Airbyte, navigate 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. Optionally, enter one or more IDs in Boards to sync to limit the Boards, Items, and Activity logs streams to specific boards. If left empty, the connector syncs records from all boards in your account.
  6. Optionally, set Number of concurrent threads to control how many requests the connector makes in parallel. The default is 4 and the allowed range is 2 to 50, but the connector caps effective concurrency at 40, 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 using 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 that appears 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 using your Monday.com credentials. The Airbyte app must be installed on your Monday.com account before it can be authorized. If it is not installed yet, Monday.com asks an account admin to install it during this step and then continues to the consent screen; if you are not an admin, ask one to install the app first. If an admin completes the authorization instead, the source syncs with the admin's permissions.

Airbyte stores the access token together with a refresh token and refreshes the access token automatically. Sources authenticated with connector versions earlier than 2.6.0 hold a legacy access token: on the first run on 2.6.0 the connector migrates it to the new OAuth flow automatically and asks you to re-authenticate only if that migration fails. Make sure the source runs 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 that has not been used for 3 months (monday.com update), so a source that does not sync for that long must be re-authenticated.

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

Upgrading to 2.6.0​

Monday.com is moving its OAuth flow to OAuth 2.1 and 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 and keeps the access token fresh with rotating refresh tokens. The connector configuration stores a refresh_token alongside the access_token, and the connector refreshes the access token automatically, persisting the newest refresh token after every refresh. This is not a breaking change: existing configurations stay valid and are migrated automatically on the first run.

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

What happens on upgrade:

  1. On Airbyte Cloud the upgrade is applied automatically through a progressive rollout. On self-managed Airbyte, upgrade the connector to 2.6.0 before October 1, 2026.
  2. On the first run on 2.6.0 (connection test or sync), the connector exchanges the existing legacy access token for a new access token and refresh token through Monday.com's token migration endpoint and stores them in the source configuration. No re-authentication is needed when this succeeds.
  3. If a run fails with an error asking you to re-authenticate, open the source in Airbyte and click Authenticate your Monday account. If the Airbyte app is not installed on your Monday.com account (for example because it was removed), Monday.com asks an account admin to install it before showing the consent screen, so have an account admin install the app first. If the admin completes the authorization, the source syncs with the admin's permissions.

The automatic migration only works while the legacy access token is still valid, so make sure the source runs once on 2.6.0 before October 1, 2026. Monday.com describes the migration endpoint as temporary and rate limited; when it rejects the token (expired or revoked token, Airbyte app removed from the account, migration disabled, or a personal API token stored in the OAuth2.0 settings) the source needs the manual re-authentication from step 3. Re-authenticating on a version earlier than 2.6.0 uses the legacy flow: it fails once the Airbyte app is switched to Monday.com's new OAuth flow, and any token it issues stops working on October 1, 2026. From that date, OAuth2.0 sources whose legacy token was not migrated stop syncing until they are re-authenticated.

Connect using 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 the following sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncYes
NamespacesNo

Supported streams​

The following streams are available:

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 column definitions for each board. In your destination, these appear as nested data, typically named boards.columns.

  • The Items stream includes column values for each item. In your destination, these appear as nested data, typically named items.column_values. Each column value includes id, text, type, and value fields. Some column types provide additional fields through typed values:

    • Connect Boards (board_relation) and Dependency (dependency) columns include a linked_item_ids array containing the IDs of linked items. Use these IDs to join back to the Items stream for details about linked items. Note that 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. Board and item IDs are extracted from activity log events and used to selectively sync only the changed records. If the time between syncs exceeds the activity log retention period for your Monday.com plan, some changes may not be captured during incremental syncs.

  • The Items stream uses cursor-based pagination, and Monday.com pagination cursors expire after 60 minutes. If reading a board takes longer than that (for example, due to rate limiting or very large boards), the API returns a CursorExpiredError and the connector restarts pagination for that stream from the beginning. Syncs of very large boards can take longer than expected as a result.

If there are additional endpoints you'd like Airbyte to support, create an issue.

Performance considerations​

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

IP allow list​

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

Reference​

Config fields reference

Field
Type
Property name
array<integer>
board_ids
object
credentials
integer
num_workers

Changelog​

Expand to review
VersionDatePull RequestSubject
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
Was this page helpful?