# Monday.com
## Overview
The monday.com connector in DBSync Cloud Workflow facilitates seamless integration with monday.com and your enterprise systems to enhance project management automation.
This connector empowers organizations to synchronize task boards, items, updates, statuses, and custom fields between monday.com and external systems, eliminating manual processes and ensuring consistent task and project data across the organization.
## Key Benefits
**For Business Users:**
* **Real-Time Project Visibility:** Keep project and task data synchronized across systems.
* **Workflow Automation:** Trigger actions based on status changes and task updates.
* **Improved Collaboration:** Unite work item data from multiple systems into a single workflow.
**For Technical Teams:**
* **Secure Integration:** Uses OAuth 2.0 for secure authentication with monday.com.
* **Flexible Data Support:** Access boards, items, columns, and updates for workflow use.
* **Trigger & Schedule Support:** Execute workflows based on events or schedules.
## Prerequisites
Before configuring the monday.com Connector, ensure the following prerequisites are met:
1. **DBSync Access**
* A valid license for this connector and access to the DBSync Cloud Workflow platform.
2. **monday.com Account**
* A monday.com user account with admin permissions.
## Connector Configuration
Each monday.com connector instance represents a connection between DBSync and a specific monday.com workspace or user account. If you need to integrate multiple accounts or workspaces, create separate connector instances.
#### Authentication (OAuth 2.0)
The monday.com connector uses OAuth 2.0 for secure authentication.
OAuth ensures that your monday.com credentials are never stored directly by DBSync, and supports continuous authorized access with automatic token refresh.
## Quick Setup Guide
Follow these steps to configure the monday.com connector:
1. **Login to DBSync Cloud Workflow**
* Use your DBSync credentials to access the platform.
2. **Add the monday.com connector**
* Navigate to the connectors list in the Apps pane and select **monday.com**.
3. **Initiate Authorization**
* Click **Login to monday.com** to launch the OAuth flow.
4. **Authenticate & Approve Access**
* Log in to your monday.com account and authorize DBSync.
5. **Verify Connection**
* The connector displays your monday.com account or workspace — confirming the connection is active.
Once configured, monday.com objects will be available within workflows for use in triggers, tasks, and sync patterns.
## Basic operations with the monday.com connector
The monday.com connector allows you to automate various data interactions, including creating items, updating boards, and retrieving data.
#### **Use Case 1: Create a new item on a board**
{% stepper %}
{% step %}
Navigate to the Flow Builder for your Automated task.
{% endstep %}
{% step %}
In the Flow Builder, drag and drop the **Flow** action and name it, as required.
{% endstep %}
{% step %}
Next, drag and drop the **Query** action. Choose the source connector, source object and configure the query.
{% endstep %}
{% step %}
Drag and drop the transform and write action and configure as below:
* Choose 'insert' from the Operation drop-down
* Choose the monday.com connector in Target
* Choose the object you want to write into
* Click **map** and map the fields.
{% hint style="info" %}
A single transform and write action can only map to one object. So, if you are querying from a single object but writing to multiple objects, you will need multiple transform and write actions.
{% endhint %}
* **Save** the mapping and close the mapping window.
* Click **Save** in the Transform and Write configure pane in the right side to save the flow.
{% endstep %}
{% step %}
Test the action to ensure the item is created on the specified board.
{% endstep %}
{% endstepper %}
#### Use Case 2: Update an existing item
{% stepper %}
{% step %}
Navigate to the Flow Builder for your Automated task.
{% endstep %}
{% step %}
In the Flow Builder, drag and drop the Flow action and name it as required.
{% endstep %}
{% step %}
Next, drag and drop the Query action. Choose the source connector, source object and configure the query.
{% endstep %}
{% step %}
Drag and drop the transform and write action and configure as below:
* Choose 'update' from the **Operation** drop-down.
* Choose the monday.com connector in **Target**.
* Choose the object you want to write into.
* Click **map** and map the fields.
* **Save** the mapping and close the mapping window.
* Click **Save** in the Transform and Write configure pane in the right side to save the flow.
{% hint style="info" %}
The primary key is essential for the update operation. It must be entered in the properties of the transform and write action, specifying the basis on which the record should update.
{% endhint %}
{% endstep %}
{% step %}
Test, and execute the flow to apply changes to the item in monday.com.
{% endstep %}
{% endstepper %}
## Advanced Configuration
### Custom Queries
Use custom GraphQL queries to fetch or manipulate data more flexibly. To do this:
{% stepper %}
{% step %}
In the query action configuration pane, in the **Configure Query** section, click to get a dropdown to switch to the advanced query builder from the visual query builder.
{% endstep %}
{% step %}
In the advanced query builder, manually write the GraphQL query, including specifying the object from which to pull data.
{% endstep %}
{% step %}
Click **Preview** to preview the records.
{% endstep %}
{% step %}
Click **Save** to save the flow.
{% endstep %}
{% endstepper %}
## Error Handling
#### Common Issues
* **Authentication Errors:** Ensure the connection is successful and you have adequate permissions to access monday.com.
* **Invalid Board or Item ID:** Ensure IDs used in workflows are correct and accessible.
* **Rate Limits:** monday.com enforces API rate limits. Implement delay or retry mechanisms in workflows to avoid hitting limits.
#### Troubleshooting Tips
* **401 Unauthorized:** Validate the connector and reconnect, if required.
* **GraphQL Syntax Errors:** Double-check the structure of custom queries.
* **Network Issues:** Confirm that DBSync has connectivity to monday.com.
## Best Practices
* **Secure API Tokens:** Do not share your API tokens and rotate them periodically.
* **Test Workflows:** Run workflows in a test environment before deploying them to production.
* **Optimize API Calls:** Avoid excessive data fetches by refining queries to request only necessary fields.
## Frequently Asked Questions (FAQ)
Can I connect multiple monday.com accounts?
Yes, configure separate connector entries for each account or workspace you need to integrate.
Is the authentication secure?
Yes, the connector uses OAuth 2.0 and tokens are securely stored by DBSync.
Are custom fields supported?
Yes, custom columns and field data in monday.com boards are accessible via the connector.
Can workflows trigger off of updates?
Yes, workflows can be designed to trigger based on events such as item creation or status changes.
Does the connector support bi-directional sync?
Yes, workflows can be configured for two-way data flows between monday.com and connected systems.
## Summary
The monday.com Connector in DBSync Cloud Workflow delivers a powerful integration solution for syncing project and task management data between monday.com and your enterprise systems. With secure authentication, flexible object access, and workflow automation capabilities, this connector helps teams streamline collaboration, automate operational processes, and ensure consistent work item data across platforms.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mydbsync.com/cloud-workflow/2026_connectors_new/monday.com.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
