Troubleshoot the Monday.com connector
This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Databricks previews.
This page describes common errors you might encounter with the managed Monday.com connector and how to resolve them.
Pipeline fails to authenticate
Cause: Monday.com returned an HTTP 401 response. This usually means the API token isn't valid, someone revoked it, or it belongs to a user that no longer has access to the requested data.
Solution:
- Verify that the API Token in the Unity Catalog connection matches an active API token in Monday.com.
- Confirm that the token's user still has access to the boards and account data that the pipeline ingests. To ingest account-wide data and board activity logs, use a token created by an account admin.
For details, see Configure authentication to Monday.com.
Monday.com API rate limit or complexity budget exceeded
Cause: Monday.com returned an HTTP 429 response. Monday.com meters the GraphQL API with a per-minute complexity budget (10 million points per minute on paid plans, 1 million on trial and free plans) in addition to per-minute request-count and concurrency limits that scale by plan. A single query is capped at 5 million complexity points. See the Monday.com API rate limits.
Solution:
The connector waits and retries automatically. If this happens repeatedly, reduce the pipeline's schedule frequency or the number of concurrent pipelines that share the same Monday.com token.
Monday.com API error
Error message:
The connector surfaces the message and error code that Monday.com returns, followed by:
For more information about Monday.com API errors, please visit: https://developer.monday.com/api-reference/docs/error-handling
Cause: Monday.com returned a GraphQL error, such as a permission or query error.
Solution:
Review the error code in the message against the Monday.com error handling reference. Confirm that the token's user has access to the requested boards and data. See Configure authentication to Monday.com.