> ## Documentation Index
> Fetch the complete documentation index at: https://beebole.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Asana integration: import projects and tasks
> Import Asana projects, tasks, and sub-tasks into Beebole for time tracking. Automatic webhook-based sync keeps your Asana workspace and Beebole account in sync.
Beebole's Asana integration imports your Asana projects, tasks, and sub-tasks into Beebole so your team can track time against their Asana work. The integration keeps your Asana workspace and Beebole account in sync automatically — when a project or task is created or renamed in Asana, the change is reflected in Beebole.
You can import your Asana structure into Beebole's **Projects and activities** for time tracking with costs, billing, and expenses, or into **Planning and tasks** for resource assignment.
| Asana | Projects and activities | Planning and tasks |
| -------- | ----------------------- | ------------------ |
| Project | Project | Task |
| Task | Subproject | Sub-task |
| Sub-task | Sub-subproject | Sub-sub-task |
***
## Before you start
You need administrative privileges in both Asana and Beebole to set up the integration.
| What syncs from Asana | What stays in Beebole |
| -------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Projects:** Imported as Beebole projects or tasks. | **Approval workflows:** Beebole handles the timesheet lifecycle. |
| **Tasks:** Imported as Beebole subprojects or sub-tasks. | **Billing rates:** Managed exclusively in Beebole. |
| **Sub-tasks:** Imported as Beebole sub-subprojects or sub-sub-tasks. | **Budgets:** Set within Beebole's billing and budget settings. |
| **Users:** Asana active users are mapped as Beebole people. | |
***
## What's included
Active projects, tasks, and sub-tasks 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 projects and tasks created in Asana are also automatically added to Beebole.
All active users in your Asana 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.
Timesheet entries, approval workflows, billing rates, budgets, and expenses remain in Beebole and are not affected by the integration.
***
## Step-by-step configuration
Go to **Settings** > **Integrations** > **Asana**. Click **Connect to Asana**.
Follow the instructions in the popup to authorize Beebole to access your Asana workspace. The popup closes automatically when the connection is complete.
Once connected, configure the following options:
* **Asana workspace** — If your Asana account is linked to more than one workspace, select the one you want to sync with Beebole.
* **Default role for imported employees** — Select the role to assign to Asana users when they are imported into Beebole.
* **Where to import your tasks** — Choose between **Projects and activities** (for project time tracking with rates and billing) or **Planning and tasks** (for resource planning and assignment).
You can review and manage existing roles in **Settings** > **Person Roles**.
Click the toggle to **Enable integration**. Beebole imports all your active Asana projects, tasks, and sub-tasks.
The initial import may take a few moments depending on the size of your Asana workspace. You can continue using Beebole while the import runs in the background.
Once complete, the integration is active. All future changes in Asana are automatically reflected in Beebole.
Click **Projects** in the sidebar to open the Projects page. Expand the categories — you should see a new category called **Asana** containing all your imported projects and tasks. You can rename this category if needed.
If you want the new Asana category to appear in the timesheet, go to **Settings** > **Account Settings** > **Timesheet settings** > **Categories** and select the Asana category.
***
## Disabling the integration
If you disable the integration, any future changes made in Asana will no longer sync to Beebole. Previously imported data remains in Beebole as local records.
To disable the integration, go to **Settings** > **Integrations** > **Asana** and toggle the integration off. You can re-enable it at any time to resume syncing.
To disconnect your Asana account entirely, click **Reset connection**.
***
## Related content
Manage your projects, subprojects, and billing rates in Beebole.
Create, organize, and assign tasks, and track time against them.
Build your own integrations using the Beebole GraphQL API.
Explore all available Beebole integrations.
***
## Frequently asked questions
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.
Changes made in Asana (new projects, tasks, 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).
The integration imports all active projects and tasks from your Asana workspace. You cannot selectively import individual projects. However, you can organize and filter imported items within Beebole after the import.
All previously imported projects, tasks, and people remain in Beebole as local records. They are not deleted. Only future changes from Asana will stop syncing until you re-enable the integration.
Yes. You need administrative privileges in both your Asana workspace and your Beebole account to set up and configure the integration.