Skip to main content

Monday

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Airbyte
Connector Version
2.5.1 (last updated 5 days ago)
Sync Success Rate
Usage Rate
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 (bottom left corner) > Admin > API.
  • An OAuth 2.0 application, which you can find or create under Profile picture (bottom left 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 Board IDs to limit syncing to specific boards. If left empty, the connector syncs data from all boards in your account.
  6. Click Set up source.

Connect using OAuth 2.0​

  1. Select OAuth2.0 in Authorization Method.
  2. Click Authenticate your Monday account.
  3. Complete the authentication flow using your Monday.com credentials.

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.

  • 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.

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

Performance considerations​

The Monday connector should not run into Monday API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.

Reference​

Config fields reference

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

Changelog​

Expand to review
VersionDatePull RequestSubject
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?