> ## Documentation Index
> Fetch the complete documentation index at: https://beebole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monday.com integration: import boards and items

> Connect monday.com to Beebole to import boards and items for time tracking. Automatic sync keeps your monday.com workspace aligned with Beebole projects.

Beebole's monday.com integration imports your monday.com boards, items, and team members into Beebole so your team can track time against their monday.com work. The integration keeps your monday.com workspace and Beebole account in sync automatically — when a board or item is created or renamed in monday.com, the change is reflected in Beebole.

You can import your monday.com structure into Beebole's **Projects and activities** for time tracking with costs, billing, and expenses, or into **Planning and tasks** for resource assignment.

| [monday.com](http://Monday.com) | Projects and activities | Planning and tasks |
| ------------------------------- | ----------------------- | ------------------ |
| Board                           | Project                 | Task               |
| Item                            | Subproject              | Sub-task           |
| Sub-item                        | Sub-subproject          | Sub-sub-task       |

***

## Before you start

<Info>
  You need administrative privileges in both monday.com and Beebole to set up the integration.
</Info>

| What syncs from [monday.com](http://Monday.com)                        | What stays in Beebole                                            |
| ---------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Boards:** Imported as Beebole projects or tasks.                     | **Approval workflows:** Beebole handles the timesheet lifecycle. |
| **Items and sub-items:** Imported as Beebole subprojects or sub-tasks. | **Billing rates:** Managed exclusively in Beebole.               |
| **Users:** monday.com users are mapped as Beebole people.              | **Budgets:** Set within Beebole's billing and budget settings.   |

***

## What's included

<AccordionGroup>
  <Accordion title="Monday.com boards and items">
    Active boards and items at the time of enabling the integration are created in Beebole. Any name change to those items is reflected in Beebole while the integration is active. New boards and items created in Monday.com are also automatically added to Beebole.

    Sub-items are supported where the board allows them and are imported as a third level beneath items.
  </Accordion>

  <Accordion title="Monday.com users">
    All active non-guest users in your Monday.com workspace are automatically created as people in Beebole when you first enable the integration. You choose a default role for these imported employees during setup.
  </Accordion>

  <Accordion title="Items managed in Beebole">
    Timesheet entries, approval workflows, billing rates, budgets, and expenses remain in Beebole and are not affected by the integration.
  </Accordion>
</AccordionGroup>

***

## Step-by-step configuration

<Steps>
  <Step title="Connect to monday.com">
    Go to **Settings** > **Integrations** > **monday.com**. Click **Connect to monday.com**.

    A popup opens to authorize Beebole to access your monday.com account. Complete the authorization flow. The popup closes automatically when the connection is established.
  </Step>

  <Step title="Configure integration parameters">
    Once connected, configure the following options:

    * **Monday.com workspace** — If your account has multiple workspaces, select the one you want to import.
    * **Where to import your boards** — Choose between **Projects and activities** (for project time tracking with rates and billing) or **Planning and tasks** (for resource planning and assignment).
    * **Default role for imported employees** — Select the role to assign to monday.com users when they are imported into Beebole.

    <Tip>
      You can review and manage existing roles in **Settings** > **Person Roles**.
    </Tip>
  </Step>

  <Step title="Enable the integration">
    Click the toggle to **Enable integration**. Beebole imports all your active monday.com boards, items, and users.

    <Info>
      The initial import may take a few moments depending on the size of your monday.com workspace. You can continue using Beebole while the import runs in the background.
    </Info>

    Once complete, the integration is active. All future name changes and new boards or items in monday.com are automatically reflected in Beebole.
  </Step>

  <Step title="Validate the integration">
    Click **Projects** in the sidebar (or **Tasks**, depending on your import mode). You should see a new category called **Monday** containing all your imported boards and items. You can rename this category if needed.
  </Step>

  <Step title="Configure the timesheet">
    If you want the new Monday category to appear in the timesheet, go to **Settings** > **Account Settings** > **Timesheet settings** > **Categories** and select the Monday category.
  </Step>
</Steps>

***

## Disabling the integration

<Warning>
  If you disable the integration, any future changes made in monday.com will no longer sync to Beebole. Previously imported data remains in Beebole as local records.
</Warning>

To disable the integration, go to **Settings** > **Integrations** > **monday.com** and toggle the integration off. You can re-enable it at any time to resume syncing.

To disconnect your monday.com account entirely, click **Reset connection**.

***

## Related content

<CardGroup cols={2}>
  <Card title="Projects and activities" icon="folder" href="/help/documentation/projects">
    Manage your projects, subprojects, and billing rates in Beebole.
  </Card>

  <Card title="Planning and tasks" icon="calendar-check" href="/help/documentation/planning">
    Create, organize, and assign tasks, and track time against them.
  </Card>

  <Card title="Custom integrations" icon="code" href="/help/integrations/custom-integrations">
    Build your own integrations using the Beebole GraphQL API.
  </Card>

  <Card title="All integrations" icon="plug" href="/help/integrations/introduction">
    Explore all available Beebole integrations.
  </Card>
</CardGroup>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What is the difference between Projects and activities and Planning and tasks?">
    Beebole's time management has two structures. **Projects and activities** can be configured with billing rates, costs, budgets, and expenses. **Planning and tasks** is a list of tasks you can assign in resource planning charts. Both can be used in the timesheet to track time. Choose the option that best fits how your organization manages work.
  </Accordion>

  <Accordion title="How often does Beebole sync with monday.com?">
    Changes made in monday.com (new boards, items, or name updates) are reflected in Beebole automatically via webhooks. In most cases, this happens within minutes. If a change is not reflected within 24 hours, contact [support@beebole.com](mailto:support@beebole.com).
  </Accordion>

  <Accordion title="Can I choose which monday.com boards to import?">
    The integration imports all active public boards from the selected workspace. You cannot selectively import individual boards. However, you can organize and filter imported items within Beebole after the import.
  </Accordion>

  <Accordion title="My monday.com account has multiple workspaces. Which one gets imported?">
    During setup, Beebole shows a **monday.com workspace** selector when your account has more than one workspace. Select the workspace you want to import before enabling the integration. Only one workspace can be connected per Beebole account.
  </Accordion>

  <Accordion title="What happens to imported data if I disable the integration?">
    All previously imported boards, items, and people remain in Beebole as local records. They are not deleted. Only future changes from monday.com will stop syncing until you re-enable the integration.
  </Accordion>
</AccordionGroup>